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Avant-propos 



Cet ouvrage est destiné, en priorité, à ceux qui veulent se former à PHP 5 et aux bases de 
données MySQL et SQLite pour créer des pages Web dynamiques et interactives. Nous y 
présentons à la fois les bases du langage, qui étaient celles de PHP 4, et les importantes 
nouveautés de la version 5, qui représente une évolution majeure. PHP s'est encore enri- 
chi dans la version 5.3, sujet de cette seconde édition, en particulier dans le domaine des 
objets avec, entre autres, l'apparition des namespaces (espaces de noms) y compris 
l'emploi du mot-clé use, du namespace global, des alias et des appels de variables stati- 
ques, ainsi que le Late State Binding et la création de constantes et de fonctions dans les 
namespaces. Notons également l'apparition de l'extension mysqli, qui permet un accès 
objet riche à MySQL, et de la couche d'abstraction PDO qui autorise l'accès aux bases 
de données les plus diverses. Avec la version 5.3 utilisée dans cette nouvelle édition, PHP 
confirme qu'il est un langage encore plus professionnel et solide, tout en conservant la 
simplicité et l'efficacité qui ont fait son immense succès. 

Les exercices proposés à la fin de chaque chapitre vous permettront une application 
immédiate des points étudiés et, grâce aux travaux personnels proposés à la fin de 
l'ouvrage, vous pourrez mettre en œuvre l'ensemble des connaissances acquises dans 
des cas réels de sites Web dynamiques. 

Les corrigés de ces exercices, téléchargeables sur le site www.editions-eyrolles.com, ainsi que 
visibles et exécutables sur le site www.funhtml.com, vous permettront de mesurer votre 
compréhension des notions abordées. 

L'ouvrage est divisé en vingt et un chapitres, qui abordent successivement les sujets 
suivants : 

• Le chapitre 1 rappelle le fonctionnement général de PHP dans la création de pages 
dynamiques. Il montre comment installer les outils nécessaires aux tests des scripts, en 
particulier le serveur Web Apache/PHP/MySQL, et dresse l'inventaire des nouveautés 
de PHP 5. 

• Le chapitre 2 définit les différents types de données manipulables avec PHP et montre 
comment les utiliser en créant des variables ou des constantes. 

• Le chapitre 3 fait un tour d'horizon des instructions de contrôle indispensables à tout 
langage. Il montre comment créer des instructions conditionnelles et des boucles ainsi 
que gérer les erreurs par le mécanisme des exceptions, une des nouveautés de PHP 5. 
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• Le chapitre 4 traite de la création et de la manipulation des chaînes de caractères. Il 
décrit les différentes techniques d'affichage, simple ou formaté, des chaînes et présente 
l'écriture d'expressions régulières. 

• Le chapitre 5 se penche sur la création de tableaux, un type de données très pratique 
aux multiples applications. Diverses techniques de lecture des tableaux sont explici- 
tées à l'aide de nombreux exemples. 

• Le chapitre 6 détaille la création des formulaires, qui sont les vecteurs indispensables 
au transfert d'informations entre le poste client et le serveur. Il montre comment récu- 
pérer et gérer les données saisies par les visiteurs d'un site. 

• Le chapitre 7 est consacré aux fonctions qui permettent une meilleure organisation 
des scripts. Le passage d'arguments par valeur et par référence ainsi que la gestion des 
paramètres et le retour des valeurs multiples par une fonction y sont détaillés. 

• Le chapitre 8 fait le tour des outils permettant le calcul des durées et la gestion des 
dates et des calendriers avec PHP. 

• Le chapitre 9 aborde le nouveau modèle objet de PHP 5 et introduit les nouvelles 
méthodes qui révolutionnent la création d'objets avec PHP, le rapprochant ainsi des 
langages de POO. 

• Le chapitre 10 montre comment PHP est capable de créer, éventuellement à partir de 
données, des images dynamiques au format GIF, JPEG ou PNG selon les besoins, 
susceptibles de rendre les sites plus attractifs. 

• Le chapitre 1 1 aborde la gestion des fichiers sur le serveur et livre une première appro- 
che du stockage, sur le serveur, d'informations issues du poste client. Les différentes 
méthodes de création de fichiers, de lecture et d'écriture de données y sont décrites en 
détail. 

• Le chapitre 12 est dédié à la création et à la gestion des cookies ainsi qu'au mécanisme 
des sessions, qui permet la conservation et la transmission d'informations entre toutes 
la pages d'un même site. La création et l'envoi d'e-mail pour renforcer les possibilités 
de contact entre l'internaute et le site sont également abordés. 

• Le chapitre 13 rappelle les notions théoriques indispensables à la modélisation d'une 
base de données. Il dresse une rapide synthèse du modèle entité/association et du 
passage au modèle relationnel, qui est utilisé par la plupart des SGBD actuels, en 
particulier MySQL et SQLite, qui font l'objet des chapitres suivants. 

• Le chapitre 14 est un rappel du langage SQL en vue de son utilisation dans MySQL. 
Ce survol est réalisé en dehors du contexte PHP au moyen de l'interface de gestion 
phpMyAdmin. 

• Le chapitre 15 explique comment accéder à une base MySQL au moyen de scripts 
PHP de manière procédurale classique dans le cadre d'un site. Y sont abordées les 
différentes commandes d'insertion et de mise à jour de données ainsi que de lecture et 
de recherche élaborées sur une ou plusieurs tables au moyen de jointures. 
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• Le chapitre 16 utilise l'extension mysqli introduite dans les dernières versions de 
PHP 5 qui permet un accès purement objet à MySQL. Elle enrichit considérablement 
les possibilités par rapport à l'accès procédural, abordé au chapitre 15, qui était de 
mise jusqu'à présent. 

• Le chapitre 17 présente la couche d'abstraction PDO qui permet l'accès à MySQL 
mais également à d'autres bases de données et qui est une solution d'avenir dans ce 
domaine. 

• Le chapitre 18 aborde la base de données embarquée SQLite, une des nouveautés de 
PHP 5. Nous l'envisageons successivement avec la méthode procédurale puis avec la 
méthode objet, plus proche de la nouvelle orientation de PHP 5. 

• Le chapitre 19 dévoile une autre nouveauté de PHP 5, SimpleXML, qui permet de 
manipuler, d'une manière nettement simplifiée par rapport à celle de la version précé- 
dente, des fichiers XML en lecture et en écriture. 

• Le chapitre 20 présente PEAR, le framework PHP le plus célèbre et le plus répandu, 
puis en donne une application complète pour la création de formulaires à partir des 
classes spécialisées fournies dans le package QuickForm. 

• En conclusion, le chapitre 21 est constitué de quatre sujets de travaux personnels, que 
vous devrez réaliser en faisant appel aux connaissances acquises tout au long des 
chapitres précédents. De difficulté croissante, ces sujets vous permettront d'évaluer de 
manière concrète la pertinence de vos acquisitions. Les corrigés de ces travaux person- 
nels sont donnés et utilisables sur le site : http://www.funhtml.com. 
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Le sigle PHP signifiait à l'origine Personal Home Page. Pour Rasmus Lerdori", l'auteur 
de ce qui allait devenir le langage de script côté serveur incorporable dans tout document 
XHTML que nous connaissons, il s'agissait alors d'ajouter quelques fonctionnalités à ses 
pages personnelles. PHP signifie aujourd'hui Php Hypertext Preprocessor car il renvoie 
à un navigateur un document XHTML construit par le moteur de script Zend Engine 2 de 
PHP, dont nous allons voir le fonctionnement. Il permet de créer des pages Web dynami- 
ques et interactives. 

Imaginez que vous soyez fan de moto et que vous vouliez présenter les photos de vos 
modèles préférés et leurs caractéristiques techniques. La création de quelques pages 
XHTML statiques, agrémentées de liens pour naviguer d'une page à l'autre, peut suffire. 
Imaginez maintenant que vous soyez rejoint par d'autres personnes qui partagent la 
même passion et que votre site présente des centaines de modèles et une rubrique de 
petites annonces et de contacts entre membres. La quantité d'informations à présenter ne 
permet plus de naviguer dans le site au moyen de liens mais réclame, dès la page 
d'accueil, un moteur de recherche. L'utilisateur saisit un ou plusieurs critères de recher- 
che, à partir desquels le code d'un script PHP crée une page contenant les informations 
recherchées et seulement elles. Chaque visiteur et chaque besoin particulier génèrent 
donc des pages différentes, personnalisées, construites dynamiquement. 

PHP permet en outre de créer des pages interactives. Une page interactive permet à un 
visiteur de saisir des données personnelles. Ces dernières sont ensuite transmises au 
serveur, où elles peuvent rester stockées dans une base de données pour être diffusées 
vers d'autres utilisateurs. Un visiteur peut, par exemple, s'enregistrer et retrouver une 
page adaptée à ses besoins lors d'une visite ultérieure. Il peut aussi envoyer des e-mails 
et des fichiers sans avoir à passer par son logiciel de messagerie. En associant toutes ces 
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caractéristiques, il est possible de créer aussi bien des sites de diffusion et de collecte 
d'information que des sites d'e-commerce, de rencontres ou des blogs. 

Pour contenir la masse d'informations collectées, PHP s'appuie généralement sur une 
base de données, généralement MySQL mais aussi SQLite avec PHP 5, et sur des serveurs 
Apache. PHP, MySQL et Apache forment d' ailleurs le trio ultradominant sur les serveurs 
Internet. Quand ce trio est associé sur un serveur à Linux, on parle de système LAMP 
(Linux, Apache, MySQL, PHP). PHP est utilisé aujourd'hui par plus de la moitié des 
sites de la planète et par les trois quarts des grandes entreprises françaises. Pour un 
serveur Windows, on parle de système WAMP, mais ceci est beaucoup moins courant. 

Vous passerez en revue dans le cours de cet ouvrage tous les outils nécessaires à la réalisa- 
tion d'un site dynamique et interactif à l'aide de PHP et d'une base de données MySQL ou 
SQLite. Les principaux avantages de ces outils sont la facilité d'apprentissage, la grande 
souplesse d'utilisation, l'excellent niveau de performance et, ce qui ne gâte rien, la gratuité. 

Pour parvenir à la réalisation des types de site que nous venons de voir nous allons 
aborder successivement les points suivants : 

• La syntaxe et les caractéristiques du langage PHP, dont la connaissance est la base 
indispensable à toute la suite. 

• Les notions essentielles du langage SQL permettant la création et la gestion des bases 
de données et la réalisation des requêtes sur ces bases. 

• Le fonctionnement et la réalisation de bases de données MySQL puis SQLite et les 
moyens d'y accéder à l'aide des fonctions spécialisées de PHP ou d'objets. 

Pour progresser rapidement il vous sera nécessaire de lire ce livre de manière linéaire au 
moins pour le début et de ne pas brûler les étapes. N'essayez donc pas de commencer par 
la fin en abordant les bases de données sans connaissance préalable de PHP ou de SQL. 

Avant de commencer 

Avant d'envisager d'écrire votre premier script, il vous faut faire le point sur les connais- 
sances nécessaires à cette réalisation. Il n'est pas envisageable de commencer cet appren- 
tissage sans aucune connaissance d'Internet et de la création de pages XHTML. Du point 
de vue matériel, vous devez de surcroît disposer des quelques outils qui vous permettront 
d'écrire et surtout de tester vos scripts sur un ordinateur personnel. 

Compétences requises 

L'objectif de cet ouvrage étant de permettre un apprentissage progressif de PHP5, la 
connaissance d'un langage de programmation quelconque n'est pas vraiment indispensable. 
Cependant, quelques notions de programmation en langage C, Java ou en JavaScript, par 
exemple, ne peuvent que rendre l'accès à PHP plus facile. En revanche, la connaissance 
du langage XHTML est recommandée puisque le serveur PHP renvoie les pages XHTML 
que vous programmez. 
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Pour ce qui concerne la méthode, commencez par télécharger et tester les exemples du 
livre, puis modifiez-en certains paramètres afin d'évaluer le rôle de chacun d'eux. Cela 
vous permettra de mieux apprécier l'effet réel d'une instruction, par exemple. 

Les outils de création 

Puisqu'il s'agit de construire des pages Web et de produire un document HTML lisible 
par un navigateur, un éditeur HTML peut convenir pour créer la structure générale des 
pages, y compris s'il est WYSIWYG, comme Dreamweaver ou WebExpert. Le code des 
scripts PHP peut quant à lui être écrit dans n'importe quel éditeur de texte, tel que le 
Bloc -note s de Windows. 

Si les éditeurs tels que Dreamweaver privilégient l'aspect visuel en cachant le code, 
d'autres outils de création très simples, comme HTML Kit, obligent le programmeur à 
voir en permanence les éléments HTML utilisés. Un bon compromis consiste à utiliser 
un éditeur WYSIWYG pour créer le design et la mise en page générale des pages Web 
puis de récupérer le fichier XHTML réalisé dans un éditeur PHP spécialisé afin d'effec- 
tuer les tests facilement après avoir installé le serveur local PHP. 

Le tableau 1-1 présente une liste d'outils de développement de scripts. 



Tableau 1-1 - Éditeurs HTML et PHP 



Produit 


Statut 


Description 


Adresse 


HTML Kit 


Gratuit 


Éditeur HTIVIL 


http://www. chami. corn 


EditPlus 


Shareware 


Éditeur XHTML permettant l'écriture 
et l'exécution de scripts PHP 


hup:/lwww. editplus.com 


Maguma Studio 


Version freeware 
ou payante 


Éditeur HTML permettant l'écriture et 
l'exécution de scripts PHP dans votre 
navigateur. Aide à la saisie des fonc- 
tions 


http:l/www. maguma.com 


NuSptiere 


Payant 


Idem, mais comporte une bonne aide 
syntaxique 


http:/lwww. nusphere. corn 


WebExpert 
1_ 


Payant 


La version 6 permet l'écriture et l'exé- 
cution faciles de scripts PHP 


http-.llsottware.visicommedia.comifrl 



Installation d'un serveur local 

Faute de disposer d'un serveur local sur votre ordinateur personnel, vous seriez obligé 
pour tester vos pages PHP de les transférer sur le serveur distant de votre hébergeur puis 
d'appeler ces pages en vous connectant au site à l'aide de votre navigateur. La moindre 
erreur de code ou la moindre modification vous obligerait à répéter toute cette procédure, 
d'où une importante perte de temps. 

Il est donc indispensable d'installer sur votre poste de travail un serveur local simulant 
votre serveur distant et vous permettant d'effectuer en direct tous les tests désirés. Vous 
aurez alors dans votre navigateur exactement le même aspect pour toutes ces pages que 
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les visiteurs de votre site quand vous aurez opéré le transfert de vos fichiers sur le serveur 
distant qui l'hébergera. 

Le serveur local comprend les éléments suivants, disponibles séparément aux adresses 
entre parenthèses : 

• Serveur Apache (http://www.apache.orgj. 

• Interpréteur de code PHP (http://www.php.net). 

• Base de données MySQL (http://www.mysql.comj. 

• Base de données SQLite (http://www.sqlite.org). 

• Utilitaire phpMyAdmin, qui permet de créer et de gérer bases et tables de données 
MySQL(http://www.phpmyadmin.net). 

• Utilitaire SQLiteManager, qui permet de créer et de gérer bases et tables de données 
SQLite (http://www.sqlttemanager.org). 

On peut trouver sur le Web divers packages complets pour Windows, Linux ou Mac, qui 
permettent d'installer en une seule opération tous ces éléments, évitant du même coup les 
problèmes de configuration. 

Un installeur est apparu à l'occasion de la sortie de PHP 5. Son auteur, Romain Bourdon, 
se montre très réactif en publiant une nouvelle version à chaque évolution. Son package, 
nommé Wampserver, téléchargeable à l'adresse http://www.wampserver.com, est destiné aux 
ordinateurs sous Windows. 

Une fois la procédure de téléchargement terminée, il vous suffit de lancer l'exécutable 
WampServer2.0b.exe, qui installe automatiquement Apache, PHP, MySQL, SQLite 
phpMyAdmin et SQLitemanager sur votre ordinateur. Si, pendant la phase d'installation, 
vous avez choisi d'installer PHP en tant que service Windows, le serveur est lancé auto- 
matiquement à chaque démarrage du système d'exploitation. 




Figure 1-1 

L'icône de Wampserver et les options d'administration 
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La figure 1-1 montre l'icône de Wampserver 2.0 telle qu'elle figurera sur votre Bureau 
Windows et le menu d'administration qui apparaît quand vous cliquez sur l'icône de 
lancement rapide ressemblant à un demi-cercle gradué. 

Si vous avez réalisé l'installation dans le dossier C:\wamp, vous obtenez l'arborescence 
illustrée à la figure 1-2. 



El 1^ wamp 
Q alias 
(B Q apps 
(±1 bin 
help 
S 1^ lang 
1^ logs 
1^ scripts 
1^ tmp 
B ^ www 

1^ chapl 
chap2 
£1 chap3 
1^ chap4 

Figure 1-2 

Arborescence du dossier d'installation de Wampserver 

Pour pouvoir être exécutés par le serveur local, tous les scripts que vous écrivez doivent être 
enregistrés dans le sous-dossier www. Dans ce dernier, vous pouvez créer un ou plusieurs 
sous-dossiers correspondant à chaque site que vous voulez tester (voir la figure 1-2). Au 
prochain lancement du serveur, ils apparaîtront dans la page d'accueil de Wampserver 
dans la rubrique « vos projets » (voir figure 1-3). 

La page d'administration du serveur local vous donne accès à différents paramètres, tels 
que l'accès à la page d'accueil de Wampserver en cliquant sur « localhost », ou l'accès 
direct à phpMyAdmin ou SQLiteManager pour gérer vos bases de données. 

La figure 1-3 montre la page d'accueil de Wampserver. Elle peut également être obtenue 
si vous entrez dans votre navigateur l'adresse http://localhost. 



Linux et IVIac OS 

Pour les partisans de Linux, il existe une version d'un installeur de serveur local nommé LAMP à l'adresse 
http:l/doc.ubuntu-fr.org/lamp 

Les amateurs de IVIac OS en trouveront un équivalent nommé MAMP à l'adresse http://www.mamp.info/ 
en/index.php. 
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Premier contact avec PHP 

Étant désormais doté de tous les outils nécessaires, vous pouvez aborder le fonctionne- 
ment de PHP et les différentes méthodes de travail que vous devrez utiliser par la suite. 

Organisation de PHP 

PHP ne repose pas sur une hiérarchie de classes regroupées en sous-ensembles (name- 
space), comme ASPNet ou Java, mais sur des modules. Le module de base, dit standard, 
permet d'accéder aux instructions élémentaires, aux différents types de données et à un 
grand nombre de fonctions. Des modules additionnels spécialisés permettent d'ajouter 
des fonctionnalités particulières, comme l'accès aux diverses bases de données et leur 
gestion. Chaque module donne accès à un grand nombre de fonctions spécialisées pour 
un domaine particulier. 

La liste des modules disponibles actuellement est visible dans la documentation générale 
du langage sur le site officiel de PHP, à l'adresse http://www.php.net. 

Vous pouvez télécharger sur le même site la documentation officielle de PHP, qui donne, 
y compris en français, la définition de toutes les fonctions existantes. Le document 
compte quelque deux mille pages au format Acrobat PDF. 

Pour savoir quels modules vous pouvez utiliser sur votre serveur local, il vous suffit de 
cliquer sur le lien phpinfo( ) de la page d'accueil de votre serveur local Wampserver (voir 
figure 1-3). 





? 








ttrtm 2.Ù rniltah Vmion 




Configuration Serveur 












ViT-JiHi ilr A|i.ii lie: 


."^ ? n 












Version de MHM: 


s, p. s 














A-bcmaih 
















*ftp 












*ocbc 




|^P.eflecOon 


















*<l.rn 






*-<^ 




























*-pno 


frn*i_niy!«il 










Vi^ii ili'MyfiOl: 


5.0.513 












Outils 




























^ phpmvadmln 




























Vos Projets 














_ thapl 














chaplU 















Figure 1-3 

Page d'administration du seneur local Apache PHP MySQL 
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Pour obtenir la même information pour le serveur qui héberge votre site, procédez de la 
façon suivante : 

1. Écrivez le script PHP suivant, d'une simplicité enfantine (vous n'en écrirez jamais 
d'aussi court donnant autant d'informations), à l'aide de l'éditeur que vous avez choisi : 

|<?php 
phpinfo( ) : 
?> 

2. Enregistrez le script sous le nom i nf o . php. Sous PHP, tous les scripts commencent par 
la ligne <? php et se terminent par ?>. Notez que, sauf recommandation spéciale de votre 
hébergeur, tous les fichiers qui contiennent des instructions PHP sont enregistrés avec 
l'extension .php. Les extensions .php3, .php4, .php5ou .phtml se rencontrent sur certains 
serveurs, suivant la configuration effectuée par l'administrateur. 

3. Transférez le fichier info. php sur votre serveur distant à l'aide d'un logiciel FTP. 
Si vous n'en avez pas, vous pouvez télécharger FileZilla, un logiciel gratuit, dont 
le fonctionnement est aussi simple que convivial, à l'adresse http://www.sourceforge.net/ 
projects/filezilla. 

4. Saisissez l'adresse http://www.votresite.com/info.php dans votre navigateur. 

Un grand nombre d'informations utiles concernant votre serveur et l'ensemble des 
modules qui y sont installés apparaissent alors (voir figure 1-4). 
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Figure 1-4 

Informations concernant le serveur fournies par pIrpinfo() 
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Il est recommandé d'imprimer ces informations et de les conserver précieusement car 
elles vous permettront de déterminer, au moment où vous en aurez besoin, si vous pouvez 
utiliser tel ou tel module ou fonction. Il serait dommage de travailler des heures à créer 
un script qui utilise des fonctions utilisables en local mais non disponibles sur votre 
serveur distant. 

Structure des fichiers XHTML 

Comme expliqué précédemment, la connaissance du langage XHTML est utile pour se 
lancer dans l'écriture de scripts PHP. Il est donc utile de connaître la structure des fichiers 
XHTML car une page dynamique PHP est bien un document XHTML envoyé par le 
serveur vers le poste client. 

Pour être conforme aux recommandations XHTML du W3C (hnpill www.w3.org), un docu- 
ment XHTML doit avoir la structure suivante (fichier pagexhtml . html ) : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=i so-8859-r' /> 

<title>Titre de la page</title> 

</head> 

<body> 

<h2>Bienvenue sur le site PHP 5 </h2> 

</body> 

</html> 

Cette page primaire est écrite en XHTML pur, et tous les visiteurs de votre site verront 
exactement le même contenu, quel que soit le moment de leur connexion. Le fichier peut 
avoir l'extension .html ou .htm car il ne contient que du code XHTML, mais il pourrait 
tout aussi bien avoir une extension .php et avoir le même rendu dans un navigateur. 

Vous pourriez lui apporter un brin de dynamisme en affichant la date du jour en tête de 
page à l'aide du code PHP suivant (fichier codephp.php) : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 

<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>Une page PHP</title> 
</head> 
<body> 

<?php 

echo "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s ' ) . "</h3><hr />"; 
echo "<h2>Bienvenue sur le site PHP 5</h2>"; 
?> 
</body> 
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I </html> 

Le code de votre nouvelle page contient les nouveaux éléments suivants, qui ne sont pas 
du XHTML : 

<?php 

echo "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s ')."</ hSXhr />": 

echo "<h2>Bienvenue sur le site PHP 5</h2>"; 

?> 

Les éléments <?php et ?> marquent respectivement le début et la fin de tout script PHP, 
qu'il soit inclus dans du code HTML ou isolé dans un fichier ne contenant que du code 
PHP. Vous pouvez inclure autant de blocs de code PHP que vous le désirez dans un docu- 
ment HTML, à condition que chacun d'eux soit délimité par ces marqueurs. 

Entre ces éléments figure le code PHP proprement dit : 

Iecho "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s')."</ hSXhr />"; 
echo "<h2>Bienvenue sur le site PHP 5</h2>": 

L'instruction echo permet d'écrire dans le document final le contenu qui la suit, que ce 
soit du texte ou le résultat retourné par une fonction, comme dans les deux lignes précé- 
dentes. Notez que les lignes de code PHP se terminent toujours par un point- virgule. 

Si vous recopiez et exécutez ce fichier dans votre navigateur, vous obtenez le résultat 
illustré à la figure 1-5, qui donne un aperçu de ce qu'est une page dynamique élémen- 
taire. Vous pourriez faire la même chose à l'aide d'un script JavaScript exécuté non pas 
sur le serveur mais par le navigateur du poste client. La différence est que la date et 
l'heure affichées ici sont celles du serveur et pas celle de votre ordinateur, comme le 
ferait JavaScript. L'un des avantages de PHP est cependant que vous n'avez pas à tenir 
compte des capacités du navigateur du visiteur. 



^ Une page - Fn^t^^^^^^^^^^^^^^^^^^^^^^^^BÊB^^M 

Fichier Édition Affichage Historique Marque-pages Outils ? 

(BÈ ' C a a ( ^ i http;//localhost/chiipVcodephp.php -d - | Coojig fi\ 



Aujourd'hui le 24 / Sep / 2008 11:09:26 



Bienvenue sur le site PHP 5 



Terminé 



Figure 1-5 

Résultat de votre première page PHP 
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Examinez maintenant le code source du document tel qu'il a été reçu par le navigateur. 
Dans Firefox, par exemple, allez dans le menu Affichage>Source de la page. Le code 
suivant s'affiche : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>Une page PHP</title> 
</head> 
<body> 

<h3> Aujourd'hui le 24 / Sep / 2008 ll:09:26</h3><hr /> 
<h2>Bienvenue sur le site PHP 5</h2> 
</body> 
</html> 

Par rapport au code du fichier codephp.php, ce qui était contenu entre les éléments <?php 
et ?>, soit : 

f <îphp 

' echo "<h3> Aujourd'hui le ". dateCd / M / Y H:m:s ')."</h3><hr />"; 
I echo ''<h2>Bienvenue sur le site PHP 5</h2>": 

l 

a été remplacé par : 

|<h3> Aujourd'hui le 24 / Sep / 2008 11:09:26</ h3><hr /> 
<h2>Bienvenue sur le site PHP 5</h2> 

L'interpréteur PHP analyse le document dans son ensemble puis renvoie le code XHTML 
tel quel, accompagné de l'évaluation des expressions contenues dans le code PHP. Cela 
fait d'ailleurs dire à certains que tout est expression dans PHP puisque tout le code peut 
être évalué comme une chaîne de caractères, un nombre ou une valeur booléenne. 

Les parties de code contenues dans les guillemets sont renvoyées dans le flux du docu- 
ment XHTML, et les balises qu'elles contiennent sont interprétées en tant que telles par 
le navigateur. C'est le cas de la deuxième ligne. La première ligne comporte une fonction 
PHP qui retourne la date du jour. Cette date est concaténée avec le texte qui l'entoure 
puis est retournée au navigateur. 

Le cycle de vie d'une page PHP est le suivant : 

• Envoi d'une requête HTTP par le navigateur client vers le serveur, du type 
http://www.monserveur.com/codephp.php. 

• Interprétation par le serveur du code PHP contenu dans la page appelée. 

• Envoi par le serveur d'un fichier dont le contenu est purement XHTML. 

Vous constatez ainsi que votre code PHP n'est jamais visible par les visiteurs de votre site. 
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Écriture du code PHP 

Le code PHP est toujours incorporé dans du code XHTML. Vous pouvez donc incorporer 
autant de scripts PHP indépendants que vous le souhaitez n'importe où dans du code 
XHTML, du moment que ces parties sont délimitées par les balises ouvrantes et fermantes 
<?phpet "?>" (repères O, Q, O et Q) ou par la forme courte <?= et ?> (repères 0 et 
©) ou encore par l'élément XHTML <script 1 anguage="php"> (repère 0), qui est rare- 
ment employé. 

Dans un fichier .php, vous pouvez à tout moment passer du code PHP au code XHTML, 
et réciproquement. C'est ce qui donne sa grande souplesse d'utilisation à ce code. 

Le listing suivant illustre cette particularité : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<?php <-0 
$variablel=" PHP 5"; 

?> 

<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 
<?php <-0 

echo "<title>Une page pleine de scripts PHP</title>" ; 
?> 

</head> 
<body> 

<script 1 anguage="php"> <— © 

echo"<hl>BONJOUR A TOUS </hl>": 
</script> 
<?php 

echo "<h2> Titre écrit par PHP</h2>": 
$variable2=" MySQL"; 

?> 

<p>Vous allez découvrir <?= Svariablel ?> <— ©</p> 
<?php ^0 
echo "<h2> Bonjour de $vari abl el</h2>" : 

?> 

<p>Utilisation de variables PHP<br />\/ous allez découvrir également 
<?php 

echo $variable2 
?> 
</p> 

<?= "<div><big>Bonjour de $variable2 </big></div>" ?> 

</body> 

</html> 

Huit mini-scripts PHP sont placés aussi bien dans l'en-tête (entre <head> et </head>) que 
dans le corps (entre <body> et </body>) ou encore même en dehors du bloc délimité par les 
éléments <html > et </html > du document XHTML. 
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Certains de ces scripts interviennent comme contenu d'un élément XHTML avec une 
syntaxe particulière. Par exemple : 

I <?= $variablel ?> 

peut être utilisé pour des instructions courtes. Il est équivalent à : 
I <?php echo Svariablel ?>. 

Attention, pour utiliser cette notation il faut que la directive short open tag soit activée 
dans le fichier de configuration de PHP 5 (le fichier php. i ni). A partir de ce document, 
vous obtenez le résultat illustré à la figure 1-6. 



^Une p<ige pleine de scripis PHP - Mp^illd Firefox 


i^|I_n|fx| 


Fichier Écfcion Affichage Historique Marque-pages Outils ? 


(Ù |http:/flocalhost/chapl/intro2.php Û ' | O" 




BONJOUR A TOUS 




Titre écrit par PHP 




Vous eSlcL clccouvrii- PIIP 5 




Bonjour de PHP 5 




Utilisation de variables PHP 

Vous allez découvrir également MySQL 




Boujoiir de MySQL 




Terminé .: 



Figure 1-6 

Résultat des mini-scripts 

Comme précédemment, la consultation du code source dans le navigateur montrerait que 
le résultat de chaque mini-script est purement XHTML et qu'aucun code PHP ne 
subsiste. 

Inclure des fichiers externes 

Comme en JavaScript, il est possible d'écrire du code PHP ou XHTML dans des fichiers 
séparés puis de les incorporer dans du code XHTML ou d'autres scripts PHP en fonction 
des besoins. Cela peut constituer un début de modularisation du code, permettant d'écrire 
une seule fois certaines parties de code et de les réutiliser dans plusieurs pages différentes, 
avec économie de temps. Cette possibilité permet notamment de créer une bibliothèque 
de fonctions d'utilisation courante. 



Introduction 

Chapitre 1 



On donne généralement aux fichiers de code PHP l'extension .inc ou .inc. php, cette 
dernière ayant l'avantage de protéger les données confidentielles que peut contenir le 
code, comme les paramètres de connexion à la base de données (login et mot de passe). 
Le contenu du fichier est interprété par le serveur. Si le fichier ne contient que vos para- 
mètres dans des variables, le serveur ne renvoie rien au poste client si quelqu'un tente de 
l'exécuter, alors qu'un navigateur affiche le contenu d'un fichier avec l'extension . i ne seule. 

Pour inclure le contenu d'un fichier externe dans du code PHP, vous disposez des fonc- 
tions recensées au tableau 1-2. 



Tableau 1-2 - 


Fonctions d'inclusion de code externe 


Fonction 


Description 


incl ude( "nom_f i chier .ext" ) 


Lors de son interprétation par le serveur, cette ligne est remplacée par 
tout le contenu du fichier précisé en paramètre, dont vous fournissez le 
nom et éventuellement l'adresse complète. En cas d'erreur, par exemple 
si le fichier n'est pas trouvé, incl ude( ) ne génère qu'une alerte, et le 
script continue. 


reqijire("nom_fichier.ext") 


A désormais un comportement identique à incl ude( ) . à la différence 
près qu'en cas d'erreur, requi re( ) provoque une erreur fatale et met fin 
au script. 


incl ude_once( "nom_fi chier .ext" ) 
requi re_once( "nom_fi chier .ext" ) 


Contrairement aux deux précédentes, ces fonctions ne sont pas exécu- 
tées plusieurs fois, même si elles figurent dans une boucle ou si elles ont 
déjà été exécutées une fois dans le code qui précède. 



L'exemple suivant utilise les possibilités d'inclusion fournies par ces fonctions pour 
créer une page XHTML à partir de quatre fichiers indépendants. Il s'agit d'un début de 
modularisation du code d'un site. Notre hypothèse est que chaque page du site a le même 
en-tête et le même pied de page et que chacune des pages ne diffère des autres que par 
son contenu. 

L'exemple comprend les fichiers suivants : 

• tete.inc.php. Contient le début du code XHTML d'une page normale (<htrtil>, <head>, 
<body>) et trois petits scripts PHP. Le dernier de ces scripts (repère O) affiche le 
bandeau commun à toutes les pages (repère 0) ainsi que le nom du fichier exécuté et 
celui du fichier inclus (repère 0). 

• corps . i ne. php. Ne contient que du code PHP affichant deux lignes de texte (repère Q). 

• corps . html . Ne contient que du code XHTML affichant deux lignes de texte (repère 0). 

• pied. inc. php. Contient un script affichant un bandeau de pied de page et deux liens 
vers des sites dignes d'intérêt (repère ©). 

• principal .php. Script utilisant les quatre précédents à l'aide des fonctions includeO 
(repère O)' incl ude_once( ) (repère©), requi reO (repère 0) et requi re_once( ) 
(repère 0). C'est le seul qui doive être appelé directement. Les autres fichiers n'étant 
que des composants, ils ne doivent normalement pas être utilisés seuls. 
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La figure 1-7 donne un aperçu du résultat obtenu. 

'•^ Exemple 1 -1 . Inclusion de fichiers externes 

Le fichier tete. inc.php : 

I<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<?php 
$variablel=" PHP 5"; 

?> 

<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=i so-8859-1" /> 
<?php 

echo "<title>Une page pleine d'inclusions $variablel</title>"; 
?> 

</head> 

<body> 

<?php 

$variableext="Ce texte provient du fichier inclus": 

echo "<div><hl style=\"border-width:5:border-style:double; 

^backg round- col or :#f fcc99; \"> 

Bienvenue sur le site Svariablel </hl>";<— © 

echo "<h3> $variableext</h3>" ; 

echo "Nom du fichier exécuté: ", $_SERVER['PHP_SELF']," &nbsp: ": <— 0 
echo " Nom du fichier inclus : ", FILE ,"</div> " ; <— © 

Le fichier corps . Inc.php : 
<?php 

echo "<hl> Ceci est le corps du document </hl>":<— © 
echo "<h2> Ceci est le corps du document </h2>"; 
?> 

Le fichier corps . html : 

<hl> Ceci est le corps du document : Avec PHP on progresse vite et avec MySQL le 

^site devient vite très dynamique </hl> 

<h2> On s'y met tout de suite!!!! </h2><— 0 

Le fichier pied, inc.php : 

<hr /> 
<?php 

echo "<div><hl style=\"border-width:3;border-style:groove; bacl<ground-col or: 
*»#ffcc99:\"> Fin de la page PHP Liens utiles : <a href=\"php.net\">php.net</a> 
^  <a href=\"mysql .org\">mysql .org</a></hl>" ; <— 0 
echo "Nom du fichier exécuté: ", $_SERVER['PHP_SELF'],"    " ; 

echo "Nom du fichier inclus: ", FILE ,"</div>"; 

?> 

i </body> 
1 </html> 
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Le fichier principal .php : 
<?php 

includeC'tete.inc.php"); <— O 
echo "<hr />"; 

incl ude_once{ "corps . Inc. php" ) ; <— © 
requi re( "corps.html ") : <— © 
requi re_once( "pied. inc. php" ) ; <— O 
?> 



£ichicr EdrtioQ Affichage Histonquc 


parque pages ^^ubls X 






&~ ' C ^ 


tiTl7i!//k>ralh(Kr/rh»pl /prinrifMLphp 


• a- ■ 







[Bienvenue sur le site PHP¥ 



Ce texte pioiient du flcbier inclus 

Nom Al firhifr exénité- rh;^! principal php Nom dn fvWff inrlm ■ C■\wîmlp'n'ww^^lKlpl^tprp mr php 

Ceci est le corps du document 
Ceci est le corps du document 

Ceci evt \e rorp*; Ai rtonimfrït * Avec PHP on progrMW \rte et avec MySQI. \e <âte devient très d>'namiqiie 

On s'y met tout de suite!!!! 





Fin de la page PHP Liens utiles : 


php.net mysql.ors 


>Joiu du tichier exécute: ckçl phnc^KiLpIq) Nom du tichier todus: C: wa 


mp w-w-v^' ch^l piedmc.plç 




Figure 1-7 

Un page composée de fichiers inclus 



Ajout de commentaires 

Il est toujours utile de commenter les scripts que vous écrivez. Lors de l'écriture, tout peut 
paraître évident, mais à la relecture, plusieurs mois plus tard, lorsqu'il s'agit d'effectuer 
des mises à jour, par exemple, autant éviter de perdre du temps à redécouvrir la logique 
adoptée auparavant. 

Les commentaires ne sont pas pris en compte par l'analyseur PHP. S'ils alourdissent un 
peu le fichier PHP en terme d'octets sur le serveur, ils ne sont pas présents dans le code 



16 



PHP 5 



XHTML renvoyé au navigateur client. Leur poids est donc sans importance pour la rapi- 
dité de transmission des pages. 

PHP supporte les trois syntaxes de commentaires suivantes : 

• commentaires sur une seule ligne introduits par les caractères // : 
I //ceci est un commentaire court sur une ligne 

• commentaires sur plusieurs lignes introduits par les caractères / * et fermés par les 
caractères */ : 

/* Ceci est commentaire abondant 
qui va occuper plusieurs lignes 
et va expliquer le code qui suit */ 

• commentaires de type UNIX, ne comportant qu'une seule ligne introduite par le carac- 
tère # : 

# commentaires de type UNIX 



2 



Variables, constantes et types 



Comme tout langage, PHP manipule des données. Pour un site dynamique, ces données 
sont variables. De plus, elles peuvent être de types différents, tel du texte sous forme de 
chaîne de caractères, comme vous en avez utilisé avec l'instruction echo, sous forme de 
nombres entiers ou décimaux ou encore sous forme de valeurs booléennes vrai ou faux 
(TRUE ou FALSE). Ces types de base sont les plus employés, mais il en existe d'autres, qui 
peuvent être des types composés, comme les tableaux et les objets, ou des types particu- 
liers, comme resource ou NULL. 

Les variables 

Une variable est le conteneur d'une valeur d'un des types utilisés par PHP (entiers, flot- 
tants, chaînes de caractères, tableaux, booléens, objets, ressource ou NULL). 

Chaque variable possède un identifiant particulier, qui commence toujours par le carac- 
tère dollar ($) suivi du nom de la variable. Les règles de création des noms de variable 
sont les suivantes : 

• Le nom commence par un caractère alphabétique, pris dans les ensembles [a-z], [A-Z] 
ou par le caractère de soulignement (_). 

• Les caractères suivants peuvent être les mêmes plus des chiffres. 

• La longueur du nom n'est pas limitée, mais il convient d'être raisonnable sous peine 
de confusion dans la saisie du code. Il est conseillé de créer des noms de variable le 
plus «parlant» possible. En relisant le code contenant la variable Snomclient, par 
exemple, vous comprenez davantage ce que vous manipulez que si vous aviez écrit $x 
ou $y. 
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• La déclaration des variables n'est pas obligatoire en début de script. C'est là une 
différence notable avec les langages fortement typés comme Java ou C. Vous pouvez 
créer des variables n'importe où, à condition bien sûr de les créer avant de les utili- 
ser, même s'il reste possible d'appeler une variable qui n'existe pas sans provoquer 
d'erreur. 

• L'initialisation des variables n'est pas non plus obligatoire et une variable non initiali- 
sée n'a pas de type précis. 

• Les noms des variables sont sensibles à la casse (majuscules et minuscules). $mavar et 
$MaVar ne désignent donc pas la même variable. 

Les noms de variables suivants sont légaux : 

$mavar 
$_mavar 
$inavar2 
$M1 
$_123 

Les suivants sont illégaux : 

$5mamar 
$*mavar 
$mavar+ 



Affectation par valeur et par référence 

L'affectation consiste à donner une valeur à une variable. Comme expliqué précédem- 
ment, lors de la création d'une variable, vous ne déclarez pas son type. C'est la valeur 
que vous lui affectez qui détermine ce type. Dans PHP, vous pouvez affecter une variable 
par valeur ou par référence. Vous verrez que les méthodes et les conséquences de ces 
deux types d'affectation sont différentes et peuvent amener des résultats inattendus, si 
vous n'y prenez garde. 

L'affectation par valeur se fait à l'aide de l'opérateur =, soit après la création de la varia- 
ble, soit en même temps. 

Dans l'exemple suivant : 

I $mavar = expression; 

la variable $mavar prend la valeur de l'expression, qui peut être une valeur numérique, par 
exemple, une chaîne de caractères littérale, mais aussi une autre variable ou encore une 
expression PHP valide contenant des fonctions. 

Dans les affectations suivantes : 

$mavar=75: 
$mavar="Paris" ; 

$mavar=7*3+2/5-91%7; //PHP évalue l'expression puis affecte le résultat 
$mavar=mysql_connect($a,$b,$c); //la fonction retourne une ressource 
$mavar=isset{$var&&($var==9) ) ; //la fonction retourne une valeur booléenne 
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remarquez l'utilisation du même nom de variable alors que les valeurs affectées sont de 
type différent. 

Dans l'affectation par valeur à l'aide de l'opérateur =, l'opérande de gauche, c'est-à-dire 
la variable à affecter, prend la valeur de l'expression contenue dans l'opérande de droite, 
et voilà tout. Toute modification ultérieure de l'opérande de droite, même s'il est lui- 
même une variable, n'a aucune incidence sur la variable affectée. 

Dans l'exemple suivant : 

$mavarl="Paris" ; 
$mavar2="Lyon" ; 
$mavar2=$mavarl ; 
$mavarl="Nantes" ; 

à la fin du code, la variable $mavar2 contient la chaîne "Paris", puisque vous lui avez 
affecté la valeur de l'expression Smavarl, et $mavarl vaut "Nantes", puisque sa valeur a été 
modifiée à la fin du script. 

Avec l'affectation par référence, toujours réalisée au moyen de l'opérateur =, l'opérande 
de droite est une variable qui doit être précédée du caractère & (esperluette). 

Dans l'exemple suivant : 

$mavarl="Paris" ; 
$mavar2="Lyon" ; 
$mavar2 = &$mavarl; 
$mavarl="Nantes" : 

la variable $mavar2 devient un alias de la variable Smavarl, et les modifications opérées sur 
Smavarl sont répercutées sur $mavar2. Plus déroutant encore pour le novice, et plus dange- 
reux aussi, toute modification apportée à la valeur de $mavar2 est répercutée dans Smavarl 
puisque $mavar2 est un alias de Smavarl. C'est ce qu'illustre le script de l'exemple 2-1. 

Exemple 2-1 . Affectation par valeur et par référence 

<?php 

//Affectation par valeur de Smavarl et Smavar2 
Smavarl="Paris" ; 

echo "\Siravarl= ", Smavarl, "<br />"; 
Smavar2="Lyon" ; 

echo "\Smavar2= ".Smavar2."<br />"; 

//Affectation par référence de Smavar2 
Smavar2 = &Smavarl; 

echo "Affectation par référence de \Smavar2 <br />"; 
echo "\Smavarl= ", Smavarl, "<br />"; 
echo "\Smavar2= ",Smavar2,"<br />"; 
echo "modification de \Smavarl <br />"; 
Smavarl="Nantes" ; 

echo "\Smavarl= ", Smavarl, "<br />"; 
echo "\Smavar2= ",Smavar2,"<br />"; 
echo "modification de \Smavar2 <br />"; 
Smavar2="Marsei lie"; 
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Iecho "\$mavarl= ",$mavarl,"<br />"; 
echo "\$mavar2= " ,$mavar2,"<br />"; 
?> 

Le résultat de l'exécution de ce script montre l'évolution des valeurs des deux variables 
après plusieurs affectations. 

$niavarl= Paris 
$niavar2= Lyon 

affectation par référence de $mavar2 

$mavarl= Paris 

$mavar2= Paris 

modification de $mavarl 

$mavarl= Nantes 

$niavar2= Nantes 

modification de $mavar2 

$niavarl= Marseille 

$niavar2= Marseille 

Lorsque vous utilisez ce type d'affectation, il est important de ne pas oublier ses effets en 
cours de script car chacune de ces deux variables change de valeur de manière sous- 
jacente chaque fois que vous intervenez sur l'autre, sans que la modification soit explici- 
tement écrite. 



Les variables prédéfinies 

PHP dispose d'un grand nombre de variables prédéfinies, qui contiennent des informa- 
tions à la fois sur le serveur et sur toutes les données qui peuvent transiter entre le poste 
client et le serveur, comme les valeurs saisies dans un formulaire (voir le chapitre 6), les 
cookies ou les sessions (voir le chapitre 13). 

Depuis PHP 4.1, ces variables se présentent sous la forme de tableaux, accessibles en 
tout point de n'importe quel script. On appelle ces tableaux superglobaux. Le tableau 2-1 
donne une brève description de ces variables sans en détailler le contenu car un certain 
nombre d'entre elles ne présentent pas un intérêt pratique immédiat. Vous aurez toute 
précision nécessaire sur leur utilisation à mesure que vous les utiliserez dans le cours de 
l'ouvrage. Reportez -vous à la section concernant les tableaux pour lire le contenu de ces 
variables. 

Tableau 2-1 - Les variables serveur PHP 

IGLOBALS Contient le nom et la valeur de toutes les variables globales du script. Les noms des variables sont 

les clés de ce tableau. 

$GLOBALS["mavar"] récupère la valeur de la variable $mavar en dehors de sa zone de visibilité 
(dans les fonctions, par exemple). 

$_COOKI E Contient le nom et la valeur des cookies enregistrés sur le poste client. Les noms des cookies sont 

les clés de ce tableau (voir le chapitre 13). 
Avant PHP 4.1, cette variable se nommait $HTTP_COOKIES_VARS. 
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Tableau 2-1 - Les variables serveur PHP (suite) 



$_ 


_ENV 


Contient le nom et la valeur des variables d'environnement qui sont ctiangeantes selon les serveurs. 
Avant PHP 4.1 , cette variable se nommait $HTTP_ENV_VARS. 


$_ 


_FILES 


Contient le nom des fictiiers téléctiarqés à partir du poste client. 
Avant PHP 4.1, cette variable se nommait $HTTP_FILES_VARS. 


$_ 


_GET 


Contient le nom et la valeur des données issues d'un formulaire envoyé par la méthode GET. Les 
noms des ctiamps du formulaire sont les clés de ce tableau (voir le ctiapitre 6). 
Avant PHP 4.1 , cette variable se nommait $HTTP_GET_VARS. 


$_ 


_POST 


Contient le nom et la valeur des données issues d'un formulaire envoyé par la méttiode POST. Les 
noms des champs du formulaire sont les clés de ce tableau. 
Avant PHP 4.1 , cette variable se nommait $HTTP_POST_VARS. 


$_ 


_REQUEST 


Contient l'ensemble des variables superglobales $_GET, $_POST, $_COOKI E et $_FI LES. 
Avant PHP 4.1 , cette variable n'existait pas. 


$_ 


.SERVER 


Contient les informations liées au serveur Web, tel le contenu des en-têtes HTTP ou le nom du 
script en cours d'exécution. Retenons les variables suivantes : 

t *^FR\/FR^"HTTP APPEPT lANnilAnF"! nui rnntipnt Ip rnrip fip Ifinniip fin navinatpiir rlipnt 

$_SERVER["HTTP_COOKIE"], qui contient le nom et la valeur des cookies lus sur le poste client 
$_SERVER["HTTP_HOST"], qui donne le nom de domaine. 
$_SERVER["SERVER_ADDR"], qui indique l'adresse IP du serveur. 

$_SERVER["PHP_SELF"], qui contient le nom du script en cours. Nous l'utiliserons souvent dans 
les formulaires. 

$_SERVER["QUERY_STRING"], qui contient la chaîne de la requête utilisée pour accéder au script. 


$_ 


.SESSION 


Contient l'ensemble des noms des variables de session et leurs valeurs. 

J 



Les opérateurs d'affectation combinée 

En plus de l'opérateur classique d'affectation =, il existe plusieurs opérateurs d'affecta- 
tion combinée. Ces opérateurs réalisent à la fois une opération entre deux opérandes et 
l'affectation du résultat à l'opérande de gauche. 

Le tableau 2-2 décrit l'ensemble de ces opérateurs. 



Tableau 2-2 - Les opérateurs d'affectation combinée 



^Opérateur 


Description 


+= 


Addition puis affectation : 

$x += $y équivaut à $x = $x + $y 

$y peut être une expression complexe dont la valeur est un nombre. 


Soustraction puis affectation : 

$x -= $y équivaut à $x = $x - $y 

$y peut être une expression complexe dont la valeur est un nombre. 


*= 


Multiplication puis affectation : 

$x *= $y équivaut à $x = $x * $y 

$y peut être une expression complexe dont la valeur est un nombre. 
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Tableau 2-2 - Les opérateurs d'affectation combinée (suite) 



1- 


Division puis affectation : 

$x /= $y équivaut à $x = $x / $y 

$y peut être une expression complexe dont la valeur est un nombre différent de 0. 


%= 


Module puis affectation : 




$x %= $y équivaut à $x = $x % $y i 




$y peut être une expression complexe dont la valeur est un nombre. 


Concaténation puis affectation : 

$x .= $y équivaut à $x = $x . $y | 
$y peut être une expression littérale dont la valeur est une cliaîne de caractères. 



Les constantes 

Vous serez parfois amené à utiliser de manière répétitive des informations devant rester 
constantes dans toutes les pages d'un même site. Il peut s'agir de texte ou de nombres qui 
reviennent souvent. Pour ne pas risquer l'écrasement accidentel de ces valeurs, qui pour- 
rait se produire si elles étaient contenues dans des variables, vous avez tout intérêt à les 
enregistrer sous forme de constantes personnalisées. 

PHP dispose d'un ensemble de constantes prédéfinies utilisables dans tous les scripts. 

Définir ses constantes personnaiisées 

Pour définir des constantes personnalisées, utilisez la fonction def ine( ), dont la syntaxe 
est la suivante : 

I boolean define(string nom_cte. divers valeur_cte, boolean casse) 

Dans cet exemple, vous attribuez la valeur valeur_cte à la constante nommée nom_cte, 
dont le nom doit être contenu dans une chaîne de caractères délimitée par des guillemets. 
Le paramètre casse vaut TRUE si le nom de la constante est insensible à la casse et FALSE 
sinon. La fonction def ine( ) retourne TRUE si la constante a bien été définie et FALSE en cas 
de problème, par exemple, si vous essayez de redéfinir une constante existante, ce qui est 
interdit. Toute tentative de modifier la valeur d'une constante en la redéfinissant provo- 
que un avertissement (warning) de la part du serveur. 



Attention 

Une constante n'étant pas précédée du signe dollar ($), vous ne pouvez l'incorporer telle quelle dans une 
chaîne comme vous le faites avec ies variables. Il vous faut donc la concaténer avec une chaîne ou la 
séparer de ce qui précède par une virgule dans l'instruction echo. 



La fonction defined(string nom_cte) permet de vérifier si une constante nommée existe. 
Elle retourne TRUE si la constante nommée nom_cte existe et FALSE sinon. Cette vérification 
peut être utile, car il est impossible de déclarer deux constantes de même nom. 
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<^ Exemple 2-2. Création et lecture de constantes 

<?php 

//définition insensible à la casse 
defineC "PI ",3.1415926535. TRUE): <-© 
//Utilisation 

echo "La constante PI vaut ",PI,"<br />"; 
echo "La constante PI vaut ",pi,"<br />"; 
//Vérification de l'existence 

if (defined( "PI")) echo "La constante PI est déjà définie" , "<br />"; 
if (defined( "pi")) echo "La constante pi est déjà définie" , "<br />"; 
//définition sensible à la casse, vérification de l'existence et utilisation 
if (define( "site" , "http: //www.f unhtml .com" , FALSE) ) <— 0 
{ 

echo "<a href=\" " ,site, " \">Lien vers mon site </ a>"; 

} 

?> 

La constante PI étant déclarée insensible à la casse (repère 0)> slle peut être utilisée sous 
la forme PI ou pi ou encore Pi ou toute autre variante. Par contre, la constante site est 
déclarée sensible à la casse (repère 0) et ne peut être utilisée qu'en minuscules. 

Les constantes prédéfinies 

Il existe dans PHP un grand nombre de constantes prédéfinies, que vous pouvez notam- 
ment utiliser dans les fonctions comme paramètres permettant de définir des options. 
Nous ne pouvons les citer toutes tant elles sont nombreuses, mais nous les définirons au 
fur et à mesure de nos besoins. 

Le tableau 2-3 définit quelques constantes utiles à connaître. Si, par curiosité, vous voulez 
afficher l'ensemble des constantes existantes, vous pouvez écrire le code suivant : 

|<?php 
print_r(get_defined_constants( )) ; 
?> 

Vous obtenez une liste impressionnante, dont un grand nombre des valeurs sont des entiers. 



Tableau 2-3 - Quelques constantes prédéfinies 



PHP_VERSION 


Version de PHP installée sur le serveur 


1 


PHP_OS 


Nom du système d'exploitation du serveur 




DEFAULT_INCLUDE_PATH 


Chemin d'accès aux fichiers par défaut 




_FILE_ 


Nom du fichier en cours d'exécution 




_LINE_ 


Numéro de la ligne en cours d'exécution 





En complément, vous trouverez à la section consacrée aux fonctions mathématiques, 
ultérieurement dans ce chapitre, une liste de constantes mathématiques classiques. 
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Les types de données 

Dans PHP, il n'existe pas de déclaration explicite du type d'une variable lors de sa créa- 
tion. Même PHP 5 reste un langage pauvrement typé comparé à Java ou au C. 

PHP permet la manipulation d'un certain nombre de types de données différents dans 
lequel on distingue : 

• Les types scalaires de base : 

- Entiers, avec le type integer, qui permet de représenter les nombres entiers dans les 
bases 10, 8 et 16. 

- Flottants, avec le type doubl e ou f 1 oat, au choix, qui représentent les nombres réels, 
ou plutôt décimaux au sens mathématique. 

- Chaînes de caractères, avec le type string. 

- Booléens, avec le type boolean, qui contient les valeurs de vérité TRUE ou FALSE (soit 
les valeurs 1 ou 0 si on veut les afficher). 

• Les types composés : 

- Tableaux, avec le type array, qui peut contenir plusieurs valeurs. 

- Objets, avec le type object. 

• Les types spéciaux : 

- Type resource. 

- Type null. 

Vous verrez dans les sections suivantes de quelle manière vous pouvez définir des varia- 
bles pour qu'elles aient un des types ci-dessus. 

Déterminer le type d'une variable 

Avant de manipuler des variables, en utilisant, par exemple, des opérateurs, il peut être 
utile de connaître leur type. Cela permet de s'assurer que le résultat obtenu est conforme 
à ce qui est attendu et qu'il n'y a pas d'incompatibilité entre les types de ces variables. 
L'opérateur d'incrémentation appliqué à une chaîne, par exemple, peut donner des résul- 
tats curieux. 

La principale fonction permettant de déterminer le type d'une valeur est gettype( ), dont 
la syntaxe est la suivante : 

I string gettype($inavar) 

Elle retourne une chaîne de caractères contenant le type de la variable en clair. 
Les fonctions suivantes permettent de vérifier si une variable est d'un type précis : 

• is_integer($var) ou is_int($var) 

• is_double($var) 

• is_string($var) 
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• i s_bool ( $var) 

• is_array($var) 

• is_object($var) 

• is_resource{$var) 

• is_null ($var) 

Elles retournent la valeur booléenne TRUE si la variable est du type recherché et FALSE dans 
le cas contraire. 

Vous pouvez savoir si une variable contient une valeur scalaire en appelant la fonction 
is_scalar($var) et, plus précisément, si elle contient une valeur numérique de type 
integer ou double en appelant la fonction is_numeric($var). 

Dans le code suivant, la variable $var est incrémentée d'une unité uniquement si elle 
contient une valeur numérique (repère O)' ^t la variable $var2 est concaténée avec la 
chaîne "à tous" uniquement si elle est de type string (repère ©) : 

<?php 
$var = 73; 

if(is_int($var)) <-© 
{ 

$var++: 

echo "La variable vaut $var <br />"; 
} 

// affiche: La variable vaut 74 
$var2="Bonjour "; 
if(is_string($var2)) <— © 
{ 

$var2.=" à tous!"; 
echo $var2; 

} 

//affiche "Bonjour à tous" 
?> 

La conversion de type 

Malgré la grande souplesse, ou le grand laxisme, selon les opinions, de PHP à l'égard des 
types des variables, il peut être indispensable de convertir explicitement une variable 
d'un type dans un autre. C'est particulièrement vrai pour les variables issues d'un formu- 
laire, ce dernier étant l'outil essentiel de communication du poste client au serveur. Ces 
variables sont toujours de type string. 

Pour convertir une variable d'un type dans un autre, utilisez la syntaxe suivante : 
I Sresult = (type_dési ré) $mavar; 

Si vous créez bien de la sorte une nouvelle variable du type désiré à partir de la première 
variable, celle-ci conserve son type initial. Si vous n'avez pas de raison de craindre de 
perdre la valeur initiale, il vous suffit de donner le même nom aux deux variables. 
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Dans l'exemple suivant, vous transformez une chaîne de caractères successivement en 
nombre décimal puis en entier et enfin en booléen : 

<?php 

$var="3.52 kilomètres"; 
$var2 = (double) $var; 

echo "\$var2= ",$var2."<br />" ;//affiche "$var2=3.52" 
$var3 = (integer) $var2; 

echo "\$var3= ",$var3."<br />" ;//affiche "$var3=3" 
$var4 = (boolean) $var3; 

echo "\$var4= ",$var4,"<br />";//affiche "$var4=l" soit la valeur true 
?> 

Vous avez également la possibilité de modifier le type de la variable elle-même au moyen 
de la fonction settype( ), dont la syntaxe est la suivante : 

I boolean settype($var,"type Jésiré") 

Elle retourne la valeur TRUE si l'opération est réalisée et FALSE dans le cas contraire. Avec 
cette fonction, le code précédent devient : 

<?php 

$var="3.52 kilomètres"; 
settype($var , "doubl e" ) ; 

echo "\$var= ",$var,"<br />" ://aff i che "$var=3.52" 
settype($var, "integer" ) ; 

echo "\$var= ",$var,"<br />" ://aff i che "$var=3" 
settype($var , "bool ean" ) ; 

echo "\$var= ",$var,"<br />" ://aff i che "$var=l" soit la valeur true 
?> 

Contrôler l'état d'une variable 

Lors de l'envoi de données d'un formulaire vers le serveur, le script qui reçoit les infor- 
mations doit pouvoir détecter l'existence d'une réponse dans les champs du formulaire. 
Les fonctions isset( ) et empty( ) permettent ce type de contrôle. 

La fonction isset( ), dont la syntaxe est la suivante : 

I boolean isset($var) 

retourne la valeur FALSE si la variable $var n'est pas initialisée ou a la valeur NULL et la 
valeur TRUE si elle a une valeur quelconque. 

La fonction empty( ), dont la syntaxe est la suivante : 

^ boolean empty($var) 

retourne la valeur TRUE si la variable $var n'est pas initialisée, a la valeur 0 ou NULL ou la 
chaîne "0", et la valeur FALSE si elle a une quelconque autre valeur. 

L'exemple suivant illustre les différences subtiles entre ces deux fonctions : 
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<?php 
$a=nul 1 : 

if(isset($a)){echo "\$a existe déjà<br />";} 
else {echo "\$a n'existe pas<br />";} 
if(empty($a)){echo "\$a est vide <br />":) 
else {echo "\$a a la valeur $a<br />";} 
//Affiche "$a n'existe pas" et "$a est vide" 
$b=0; 

if(isset($b)){echo "\$b existe déjà<br />";} 
else {echo "\$b n'existe pas<br />";} 
if(empty($b)){echo "\$b est vide <br />";) 
else {echo "\$b a la valeur $b<br />";} 
//Affiche "$b existe déjà" et "$b est vide" 
$c=l: 

if(isset($c)){echo "\$c existe déjà<br />";} 
else {echo "\$c n'existe pas<br />";} 
if(empty($c))(echo "\$b est vide <br />";) 
else {echo "\$c a la valeur $c<br />";} 
//Affiche "$c existe déjà" et "$c a la valeur 1" 
?> 

Pour la variable $a qui a la valeur NULL, isset( ) retourne également FALSE et empty( ). Pour 
$b, qui a la valeur 0, issetO permet de détecter l'existence de cette variable bien que 
empty( ) la déclare vide. Il en irait de même si $b était une chaîne vide. 

Pour une valeur numérique affectée à la variable $c, les deux fonctions retournent TRUE. 
Ces fonctions, et en particulier issetO, vous permettront de vérifier si un utilisateur a 
bien rempli tous les champs d'un formulaire (voir le chapitre 6). 

Les entiers 

Le type integer est affecté aux variables qui contiennent des valeurs entières positives ou 
négatives en base 10 (décimal), en base 8 (octal) ou en base 16 (hexadécimal). 

Les entiers sont codés sur 32 bits sur la plupart des plates-formes, mais cela peut varier 
en fonction des serveurs. L'intervalle de valeur des entiers est donc dans ce cas de 
- 2 147 483 648, soit - 2^1 à + 2 147 483 647, soit 2^1 - 1 en base 10. 

Si une opération sur une variable de type i nteger l'amène à contenir une valeur en dehors 
de cet intervalle, elle est automatiquement convertie en type double et conserve sa 
nouvelle valeur. 

Les nombres en base 10 s'écrivent de la manière, que chacun connaît : 

|$varint = 1789; 
Svarint = -758; 

Les nombres en base 8 doivent commencer par le chiffre 0, précédé éventuellement d'un 
signe et suivi de un ou plusieurs chiffres strictement inférieurs à 8 : 

I$varoct = 03267; 
echo $varoct;//va afficher 1719 
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soit la valeur 3 x 8^ + 2 x 8^ + 6 x 8^ + 7 x 8", donc 1719 en décimal. 

Notez que PHP n'affiche pas directement les valeurs en octal et que l'utilisation de 
l'instruction echo $varoct n'affiche donc pas 03267 mais la valeur décimale 1719. 

Les sections suivantes donnent les différentes fonctions de conversion entre les bases 
de numération. 

Les nombres en base 16 commencent par les caractères Ox, ou OX, au choix, suivis de un 
ou plusieurs chiffres (de 0 à 9) ou des lettres A (pour 10) à F (pour 15) : 

|$varhex = 0xFAC7: 
echo $varhex;//Afficlie 64199 

soit, en décimal, la valeur : 

15 X 163 + 10 X 162 + 12 X 161 + 7 X 16° = 64199. 

Là encore, la deuxième ligne de code n'affiche pas la valeur hexadécimale. Pour afficher 
la valeur hexadécimale, utilisez les fonctions de conversion mathématiques, présentées 
ultérieurement dans ce chapitre. 

Les flottants 

Le type doubl e est censé représenter les nombres réels. En fait, une représentation exacte 
des réels est impossible à réaliser dans la plupart des cas avec un nombre de bits limités, 
ici 32 bits. 

En toute rigueur, le type double représente l'ensemble des nombres décimaux avec une 
précision de 14 chiffres, ce qui est suffisant dans la plupart des cas. Ce n'est pas un détail 
si vous voulez procéder à des calculs précis, scientifiques par exemple. 

Pour effectuer des calculs plus précis qu'avec des nombres de type double, vous pouvez 
utiliser la bibliothèque BCMath. Présente par défaut dans Wampserver et sur de 
nombreux serveurs susceptibles d'héberger votre site, elle fournit un éventail de fonc- 
tions de calcul avec une précision choisie à l'avance (pour plus de détails voir la page 
http://fr2.php.net/manual/fr/book.bc.php). 

PHP admet pour les nombres flottants la notation décimale classique, avec le point 
comme séparateur, et la notation exponentielle, dite scientifique, avec le symbole e ou E. 

Vous pouvez donc avoir les notations suivantes : 

<?php 

$vardbl = 1952.36; 

$vardbl2= 1.95236E3;//Soit 1.95236 x 1000 
echo $vardbl2."<br />" ;//Aff i che 1952.36 
$vardbl3= 1.95236e3: 

echo $vardbl3."<br />";//Affiche 1952.36 

echo $vardbl3*100000000000,"<br />" ;//Aff i che 1.95236E14 

?> 



Variables, constantes et types H 
Chapitre2^^ 

L'affichage se fait sous forme décimale tant que le nombre a moins de 15 chiffres. Au- 
delà, il est fait sous forme exponentielle. 

Les opérateurs numériques 

PHP offre un large éventail d'opérateurs utilisables avec des nombres. Les variables ou 
les nombres sur lesquels agissent ces opérateurs sont appelés les opérandes. 

Le tableau 2-4 donne la description de ces opérateurs, dont la plupart vous sont certaine- 
ment familiers. 



Tableau 2-4 - Les opérateurs numériques 



Opérateur 


Description 


+ 


Addition 


Soustraction 


* 


Multiplication 


/ 


Division 


% 


Module : reste de la division du premier opérande par le deuxième. Fonctionne aussi avec des 
opérandes décimaux. Dans ce cas, PHP ne tient compte que des parties entières de chacun 
des opérandes. 
$var = 159; 

echo $var%7; //affiche 5 car 159=22x7 + 5. 
$var = 10.5; 

echo $var^3.5; //affiche let non pas 0. 


Décrémentation : soustrait une unité à la variable. Il existe deux possibilités, la prédécrémentation, 
qui soustrait avant d'utiliser la variable, et la postdécrémentation, qui soustrait après avoir utilisé la 
variable. 
$var=56; 

ectio $vai — ; //affiche 56 puis décrémente $var. 
ectio $var; //affictie 55. 

ectio --$var; //décrémente $var puis affiche 54. 


++ Incrémentation : ajoute une unité à la variable. Il existe deux possibilités, la préincrémentation, qui 
ajoute 1 avant d'utiliser la variable, et la postincrémentation, qui ajoute 1 après avoir utilisé la variable. 
$var=56; 

echo $var-H-; //affiche 56 puis incrémente $var. 
echo $var: //affiche 57. 

echo -H-$var; //incrémente $var puis affiche 58. 



Les fonctions mathématiques 

Le module de base de PHP offre un grand nombre de fonctions mathématiques utiles. 
Les noms des fonctions n'étant pas sensibles à la casse, vous pouvez écrire abs( ), Abs( ) 
ou ABS( ) pour la fonction valeur absolue, par exemple. 

Le tableau 2-5 récapitule les fonctions mathématiques offertes par PHP. 
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Tableau 2-5 - Les fonctions mathématiques 



double/integer abs (double/integer X) 


Valeur absolue de X : 






echo abs(-543): //affiche 543. 


double acos (double X) 




Arc cosinus de X, qui doit être compris entre — 1 et + 1 . Le 
résultat est en radians : 

echo acos(0.5); // affiche 1.0471975511966. 


double acosh (double X) 




Arc cosinus hyperbolique de X. Ne fonctionne pas sous 
Windows. 


double asin (double X) 




Arc sinus de X, qui doit être compris entre - 1 et + 1 . Le résultat 
est en radians : 

echo asin(0.5); // affiche 0.5235987755983. 


double asinh (double X) 




Arc sinus hyperbolique de X. Ne fonctionne pas sous Windows. 


double atan (double X) 




Arc tangente de X. Le résultat est en radians : 

echo atan(5);// affiche 0.46364760900081. 


double atan2 (double Y. double 


X ) 


Arc tangente du rapport Y/X. Le résultat est en radians. Il faut 
que Y soit différent de 0. 


double atanh (double X) 




Arc tangente hyperbolique de X. 


string base_convert (string N. 
integer Bl, integer B2) 




Convertit le nombre N contenu dans une chaîne de la base B1 
dans la base B2. 


integer bindec (string X) 




Convertit un nombre binaire X contenu dans une chaîne en 
base 1 0. 


double ce il (double X) 




Retourne l'entier immédiatement supérieur à X. 


Hniihlp rn^ fHniihlp X^ 




Cosinus de X qui doit être exprimé en radians. 


Hniihlp rn<^h ^Hniihlp XI 




Cosinus hyperbolique de X. 


string decbin (integer X) 




Convertit X de la base 10 en binaire. 


string dechex (integer X) 




Convertit X de la base 10 en hexadécimal. 


string decoct (integer X) 




Convertit X de la base 10 en octal. 


double deg2rad (double X) 




Convertit X de degrés en radians. 


double exp (double X) 




Exponentielle de X, soit e'*. 


double expml (double X) 




Retourne l'exponentielle de X — 1 , soit ex —1 


double floor (double X) 




Retourne la partie entière de X, soit l'entier immédiatement 
inférieur à X. 


double fmod (double X, double 


r) 


Retourne le reste de la division de Y par X pour des opérandes 
de type double. 


integer getrandmax (void) 




Indique la valeur maximale retournée par la fonction rand( ). 


integer hexdec (string CH) 




Convertit la chaîne hexadécimale CH en décimal. 


double hypot (double X, double 


Y) 


Retourne la valeur de l'hypoténuse d'un triangle rectangle dont 
les côtés de l'angle droit sont X et Y, donc la valeur de la racine 
carrée de (X^ + Y^ ). 
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Tableau 2-5 - Les fonctions mathématiques (suite) 



boolean is_finite ( double X) 




Retourne TRUE si la valeur X est finie, c'est-à-dire dans l'inter- 
valle des valeurs admises pour un double, et FALSE dans le cas 

LUlILldlIC. 


UUUIcdll Ib llll IrlILc ^ UUUUIc A ) 




Retourne TRUE si la valeur X est supérieure à la valeur maxi- 
male admise pour un double, et FALSE dans le cas contraire. 


boolean is_nan (double X) 




Retourne TRUE si la valeur X n'est pas un nombre, et FALSE 
dans le cas contraire. 


double lcg_value (void) 




Retourne un nombre aléatoire compris entre 0 et 1 . 


double log (double X, double B) 




Logarithme népérien (de base e) du nombre X. 


double loglO (double X) 




Logarithme décimal (de base 10) de X. 


double loglp (double X) 




Logarithme népérien de (1 -i- X). 


doubl e/i nteger max (double/integer 
double/integer Y) 


X. 


Retourne la valeur maximale de X et de Y. 


double/integer min (double/integer X, 
double/integer Y) 


Retourne la valeur minimale de X et de Y. 


integer mt_getrandmax (void) 




Retourne la plus grande valeur aléatoire que peut retourner la 
fonction mt_rand( ). 


i nteger mt_rand ( integer Min, integer 
Max) 


Génère un résultat compris entre Min et Max ou entre 0 et la 
constante RAND_MAX si vous omettez les paramètres. 


void mt_srand ( integer N) 




Initialise le générateur de nombres aléatoires pour la fonction 
mt rând(). Le paramètre A/ est un entier c|uelconc|ue. 


integer octdec (string CH) 




Convertit un nombre octal contenu dans la chaîne CH en 
base 1 0. 


double pi (void) 




Retourne la valeur de pi . 


double/integer pow (double/integer 
double/integer Y) 


X. 


Calcule X à la puissance Y. Les paramètres peuvent être 
entiers ou décimaux. 


double rad2deg (double X) 




Convertit X de radians en degrés. 


integer rand (integer Min. integer 


Max) 


Retourne un nombre aléatoire compris entre Min et Max y 
compris les bornes. 


double round (double X, integer N) 




Arrondit X avec N décimales. 


double sin (double X) 




Sinus de X exprimé en radians. 


double sinh (double X) 




Sinus hyperbolique de X. 


double sqrt (double X) 




Racine carrée de X (qui doit être positif). 


void srand (integer N) 




Initialise le générateur de nombres aléatoires de la fonction 
rand( ). Le paramètre N est un entier quelconque. 


double tan (double X) 




Tangente de X qui doit être en radians. 


double tanh (double X) 




Tangente hyperbolique de X. 
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Les booléens 

L'utilisation d'expressions booléennes est à la base de la création des instructions condi- 
tionnelles, qui permettent de gérer le déroulement d'un algorithme. 

En plus de la définition du type boolean, il est important de connaître la manière dont 
PHP procède à l'évaluation des expressions dans un contexte booléen. Certaines évalua- 
tions ne sont pas du tout intuitives et peuvent donner des résultats inattendus au premier 
abord. 

Le type boolean 

Le type boolean est sûrement le plus simple puisqu'il ne peut contenir que deux valeurs 
différentes TRUE ou FALSE, correspondant aux valeurs vrai et faux qui peuvent être prises 
par une expression conditionnelle. Par exemple, $a < 75 est évaluée à TRUE si $a vaut 74 et 
à FALSE si $ a vaut 76. 

L'exemple de code suivant : 

<?php 
$a=80: 

$b= ($a<95); 

echo "\$sb vaut ",$b,"<br />"; 
?> 

affiche $b vaut 1. 

La variable $b est de type boolean car elle est le résultat de l'expression $a<95. Sa valeur 
est TRUE. PHP assimile en interne la valeur TRUE à 1 et la valeur FALSE à 0, ce qui est un 
héritage de PHP 3, dans lequel le type boolean n'existait pas explicitement. C'est pour 
cette raison que l'affichage de $b est 1 au lieu de TRUE et une chaîne vide au lieu de 0 si $b 
vaut FALSE, ce qui peut être déconcertant. 

Vous pouvez bien sûr affecter directement des variables avec des valeurs booléennes, 
comme ci-dessous : 

|$vart = TRUE;//ou encore $vart =true 
$varf = FALSE://ou encore $varf =false 

Cette méthode n'est toutefois à utiliser que pour modifier explicitement la valeur d'une 
variable existante ou pour s'assurer de l'existence d'une valeur par défaut. 

Nous manipulons généralement non pas des variables booléennes mais des expressions 
à valeur booléenne dans des instructions conditionnelles, comme if($a<95), dans 
laquelle l'expression $a<95 a une évaluation à TRUE ou à FALSE selon la valeur de $a. 

L'expression peut être une fonction dont la valeur de retour est un booléen. PHP réalise 
une évaluation booléenne d'un certain nombre d'expressions qui ne comportent pas 
d'opérateurs de comparaison. 
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Vous pouvez donc écrire : 

|$a=15: 
if($a) {echo "$a existe et vaut $a";} 

L'expression entre parenthèses qui ne contient que la variable $a est évaluée à TRUE car la 
variable $a existe et a une valeur non nulle. Dans le contexte d'évaluation booléenne de 
l'instruction if la valeur de $a n'a pas d'importance. 

Vous pouvez traduire if($a) par « si $a existe et a une valeur», ce qui est vrai dans 
l'exemple ci-dessus. Chaque expression simple ou complexe peut donc être évaluée par 
une valeur booléenne en dehors de sa valeur propre, numérique ou autre. 

Évaluation booléenne des expressions 

Le tableau 2-6 indique la manière dont sont évaluées les expressions PHP dans un 
contexte booléen. Il est important de bien connaître ces règles. 



Tableau 2-6 - Règles d'évaluation booléenne des expressions 



Expressions 


- Le mot-clé FALSE 


évaluées à FALSE 


- La valeur entière 0 de type integer 




- La valeur décimale 0 . 0 de type double 




- La chaîne "0" de type string 




- Une variable de type NULL 




- Une variable non initialisée 




- Un tableau vide 




- Un objet sans propriété ni méthode 




- Une expression logique fausse utilisant un ou plusieurs opérateurs 


Expressions 


Toutes les autres possibilités, y compris l'entier -1, car il est non nul, et la chaîne "f al se". 


évaluées à TRUE 


car elle est non vide. Les variables de type resource sont également évaluées à TRUE. 



Les opérateurs booléens 

Quand ils sont associés, les opérateurs booléens servent à écrire des expressions simples 
ou complexes, qui sont évaluées par une valeur booléenne TRUE ou FALSE. 

Typiquement utilisés dans les instructions conditionnelles (voir le chapitre 3), ils se 
décomposent en deux catégories : les opérateurs de comparaison (voir tableau 2-7), qui 
testent, par exemple, l'égalité de deux valeurs, et les opérateurs logiques proprement dits, 
qui servent à écrire des expressions composées (voir tableau 2-8). 

Il est important de bien manipuler ces opérateurs car ils sont à la base de l'élaboration des 
expressions conditionnelles complexes. En règle générale, les opérandes de ces opéra- 
teurs sont des expressions plus ou moins complexes. 
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Tableau 2-7 - Les opérateurs de comparaison 



Opérateur Description 

Teste l'égalité de deux valeurs. 

L'expression $a == $b vaut TRUE si la valeur de $a est égale à celle de $b et FALSE dans le cas 
contraire : 
$a = 345; 
$b = "345"; 
$c = ($a==$b); 

$c est un booléen qui vaut TRUE cardans un contexte de comparaison numérique, la otiaîne "345" 
est évaluée comme le nombre 345. Si $b="345 éléphants" nous obtenons le même résultat. 

! = ou <> Teste l'inégalité de deux valeurs. 

L'expression $a != $b vaut TRUE si la valeur de $a est différente de celle de $b et FALSE dans le 
cas contraire. 

=== Teste l'identité des valeurs et des types de deux expressions. 

L'expression $a === $b vaut TRUE si la valeur de $a est égale à celle de $b et que $a et $b sont 

du même type. Elle vaut FALSE dans le cas contraire : 

$a = 345; 

$b = "345"; 

$c = ($a===$b) ; 

$c est un booléen qui vaut FALSE car si les valeurs sont égales, les types sont différents (integer 
et string). 

I == Teste la non-identité de deux expressions. 

L'expression $a !== $b vaut TRUE si la valeur de $a est différente de celle de $b ou si $a et $b sont 

d'un type différent. Dans le cas contraire, elle vaut FALSE : 

$a = 345; 

$b = "345"; 

$c = ($a!==$b); 

$c est un booléen qui vaut TRUE car si les valeurs sont égales, les types sont différents (integer et 
string). 



< 


Teste si le premier opérande est strictement inférieur au second. 




<= 


Teste si le premier opérande est inférieur ou égal au second. 




> 


Teste si le premier opérande est strictement supérieur au second. 




>= 


Teste si le premier opérande est supérieur ou égal au second. 


J 


Tableau 2-8 - Les opérateurs logiques 


Opérateur 


Description 




OR 


Teste si l'un au moins des opérandes a la valeur TRUE : 
$a = true; 
$b = false; 
$c = false; 

$d = ($a OR $b);//$d vaut TRUE. 
$e = ($b OR $c); //$e vaut FALSE. 




1 1 Équivaut à l'opérateur OR mais n'a pas la même priorité. 
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Tableau 2-8 - Les opérateurs logiques (suite) 



XOR 


Teste si un et un seul des opérandes a la valeur TRUE : 
$a = true; 
$b = true; 
$c = false; 

$d = ($a XOR $b); //$d vaut FALSE. 
$e = ($b XOR $c); //$e vaut TRUE. 




AND 


Teste si les deux opérandes valent TRUE en même temps : 
$a = true; 
$b = true; 
$c = false; 

$d = ($a AND $b); //$d vaut TRUE. 
$e = ($b AND $c); //$e vaut FALSE. 




&& Equivaut à l'opérateur AND mais n'a pas la même priorité. 


! Opérateur unaire de négation, qui inverse la valeur de l'opérande : 
$a = TRUE: 
$b = FALSE; 

$d = !$a; //$cl vaut FALSE. 
$e = !$b; //$e vaut TRUE. 



Attention 

Une erreur classique dans l'écriture des expressions conditionnelles consiste à confondre l'opérateur de 
comparaison == avec l'opérateur d'affectation =. 

L'usage des parentfièses dans la rédaction des expressions booléennes est souvent indispensable et 
toujours recommandé pour éviter les problèmes liés à l'ordre d'évaluation des opérateurs. 



Les chaînes de caractères 

Les chaînes de caractères sont avec les nombres les types de données les plus manipulés sur 
un site Web. De surcroît, dans les échanges entre le client et le serveur au moyen de formu- 
laires, toutes les données sont transmises sous forme de chaînes, d'où leur importance. 



Définir des chaînes 

Une chaîne de caractères est une suite de caractères alphanumériques contenus entre des 
guillemets simples (apostrophes) ou doubles. Par exemple : 

|$a = 'PHP5 et MySQL'; 
$b = "PHP5 et MySQL": 

Si les chaînes ne contiennent que des caractères, les deux types de notation sont parfaite- 
ment équivalents. Si une chaîne contient une variable, celle-ci est évaluée, et sa valeur 
incorporée à la chaîne uniquement si vous utilisez des guillemets et non des apostrophes : 



I $a = 'PHP' 
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$b = 'MySQL': 

$c = "PHP et $b"://affiche : PHP et MySQL 
$d = 'PHP et $b' : 

/*affiche PHP et $b car $ et b sont considérés comme des caractères sans 
^signification particulière*/ 

Se pose alors la question de l'inclusion des guillemets simples ou doubles comme carac- 
tères normaux à l'intérieur d'une chaîne. 

Pour inclure une apostrophe dans une chaîne délimitée par des apostrophes, il faut les 
faire précéder du caractère d'échappement antislash \. Le principe est le même pour 
les guillemets. 

L'exemple suivant : 

|$a = 'Faire l\'ouverture '; 
echo $a; 

affiche le texte « Faire l'ouverture », et le suivant : 

|$b = "Sa devise est : \"Liberté, Égalité, Fraternité\" "; 
echo $b; 

affiche « Sa devise est : "Liberté, Égalité, Fraternité" ». 

Si vous voulez utiliser le caractère \ en tant que tel dans une chaîne, vous devez le faire 
précéder d'un autre antislash. 

L'exemple suivant : 

|$path = "C:\\php\\www\\exemple.php"; 
echo Spath; 

affiche « C:\php\www\exemple.php ». 

Le tableau 2-9 indique les séquences d'échappement utiles en PHP. 



Tableau 2-9 - Les séquences d'échappement 



Séquence 


Signification 


\' 


Affiche une apostrophe. 


\" 


Affiche des guillemets. 


\$ 


Affiche le signe $. 


W 


Affiche un antislash. 


\n 


Nouvelle ligne (code ASCII OxOA). 


\r 


Retour chariot (code ASCII OxOD). 


\t 


Tabulation horizontale (code ASCII 0x09). 


\[0-7] {1,3) 

L 


Séquence de caractères désignant un nombre octal (de 1 à 3 caractères 0 à 7) et 

affichant le caractère correspondant : 

echo "\115\171\123\121\114"; //Affiche MySQL. 
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Tableau 2-9 - Les séquences d'échappement (suite) 



\x[0-9 A-F a-f] {1.2} 



Séquence de caractères désignant un nombre hexadécimal (de 1 à 2 caractères 
0 à 9 et A à F ou a à f) et affictiant le caractère correspondant : 
echo "\x4D\x79\x53\x51\x4C"; //Affiche MySQL. 



Concaténer des chaînes 

L'opérateur PHP de concaténation est le point (.), qui fusionne deux chaînes littérales ou 
contenues dans des variables en une seule chaîne. 

Le code suivant : 



Lors de l'affichage avec l'instruction echo, cette concaténation peut être simulée en sépa- 
rant chaque chaîne ou variable par une virgule. 

L'exemple suivant : 

I echo "Utilisez ",$a," et ".$b, " pour construire un site dynamique"; 

affiche le même résultat, mais aucune chaîne ne contient l'ensemble du texte. 

De nombreuses fonctions permettent d'effectuer toutes sortes de manipulations sur les 
chaînes de caractères. Le chapitre 4 leur est entièrement consacré. 



Les tableaux représentent un type composé car ils permettent de stocker sous un même 
nom de variable plusieurs valeurs indépendantes d'un des types de base que vous venez 
de voir. C'est comme un tiroir divisé en compartiments. Chaque compartiment, que nous 
nommerons un élément du tableau, est repéré par un indice numérique (le premier ayant 
par défaut la valeur 0 et non 1). D'où l'expression de tableau indicé. 

Chaque élément peut aussi être identifié par une étiquette, qui est une chaîne de carac- 
tères ou une variable de type stri ng, nommée clé, associée à l'élément du tableau. Ce type 
de tableau est appelé tableau associatif. 

Les éléments de ces tableaux peuvent être de type integer, double, boolean, string ou 
même array, ce qui permet de créer des tableaux de tableaux, c'est-à-dire des tableaux 
multidimensionnels, ce que PHP ne permet pas explicitement, contrairement à d'autres 
langages. 



$a = "PHP": 

$b = "MySQL": 

$c = "Utilisez ".$a." 

echo $c: 



et ".$b. " pour construire un site dynamique": 



affiche : 



I Utilisez PHP et MySQL pour construire un site dynamique 



Les tableaux 
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Les éléments d'un tableau pourraient aussi être des types object ou resource, qui sont 
présentés dans les sections suivantes. 

D'une manière primaire, vous définissez la valeur d'un élément de tableau indicé à l'aide 
de la syntaxe à crochets [], avec un nom de variable, suivi des crochets, qui contiennent 
l'indice ou la variable de type integer : 

$tab[0] = 2004; 

$tab[l] = 31.14E7: 

$tab[2] = "PHP5": 

$tab[35] = $tab[2]. "et MySQL"; 

$tab[] = TRLIE://voir les paragraphes suivants 

$ind = 40; 

$tab[$ind] = "Dernier élément"; 

echo "Nombre d'éléments = ", count($tab); 

La variable $tab est un tableau par le simple fait que son nom est suivi de crochets et d'un 
indice. Il contient maintenant six éléments de types variés. 

Les trois premiers éléments sont affectés en utilisant des indices incrémentés d'une unité. 
Pour le quatrième élément, l'indice utilisé ne succède pas aux précédents. Cela implique 
que les éléments d'indice 3 à 34 sont non seulement vides mais n'existent pas. En effet, 
la fonction count($tab), qui retourne le nombre d'éléments du tableau qui lui est passé en 
paramètre, retourne ici la valeur 6 (en réalité, ces éléments sont de type NULL). 

L'élément suivant est affecté sans qu'aucun indice soit précisé. Dans ce cas, il a automa- 
tiquement l'indice suivant celui de l'élément précédemment affecté, soit ici l'indice 36. 
L'avantage de cette syntaxe est de permettre d'ajouter un nouvel élément à la fin d'un 
tableau sans connaître la valeur du premier indice disponible. 

Le dernier élément est créé en lui donnant comme indice la valeur d'une variable de type 
integer qui est de 40. 

Pour lire la valeur d'un élément de tableau dans un script, il suffit d'utiliser la même 
syntaxe en précisant l'indice de la valeur désirée. 

L'exemple suivant : 

Iecho "<p> Le langage préféré de l'Open source est $tab[2] <br />"; 
echo " Utilisez $tab[35] </p>"; 

affiche : 

Le langage préféré de l'Open source est PHP 
Utilisez PHP et MySQL 



La syntaxe permettant de définir les éléments de tableaux associatifs est similaire, mais 
vous remplacez l'indice numérique par une chaîne de caractères quelconques ou par une 
variable ou une constante de type string. Il ne faut donc pas oublier d'inclure cette 
chaîne dans des apostrophes ou des guillemets, faute de quoi vous vous exposez à quel- 
ques problèmes dans des cas particuliers. 
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Pour bien voir le danger de ne pas utiliser de guillemets pour définir les clés, analysez le 
code suivant, dans lequel l'élément de clé "lang" est défini avec la valeur "PHP et MySQL" 
puis un élément dont la clé est CTE (sans guillemets) et la valeur "ASP.NET". Comme vous 
n'avez pas utilisé les guillemets, CTE ne représente pas la chaîne "CTE" mais la valeur d'une 
constante définie précédemment et dont la valeur est "lang". En affichant $tab2["l ang"] 
vous obtenez la valeur "ASP.NET" et non "PHP ET MySQL", laquelle a été écrasée. De même, 
en affichant $tab2["CTE"], vous obtenez la valeur "JAVA". 

L'utilisation d'éléments de tableau associatif dans des chaînes pose problème. 

Le fait d'écrire : 

I echo "<p> Vous utilisez $tab2['deux'] <br />"; 

provoque une erreur et l'arrêt du script, ce qui ne se produit pas avec un tableau indicé. 
Pour pallier cet inconvénient, il faut que la variable soit contenue dans des accolades, 
comme dans l'exemple ci-dessous : 

I echo "<p> Vous utilisez {$tab2['deux']} <br />"; 

qui réalise un affichage normal, ou encore concaténer les chaînes et la variable comme 
ci-dessous : 

I echo "<p> Vous uti 1 isez" .$tab2[ 'deux' ] . " <br />"; 

Exemple 2-2. Création de tableaux associatifs 

<?php 

$tab2["zéro"] = 2003; 
$tab2['un'] = 31.14E7: 
$tab2["deux"] = "PHP"; 

//***La ligne suivante provoque une erreur si elle est décommentée 
//echo "<p> Vous utilisez $tab2['deux'] <br />"; 
//***on écrira à la place: 

echo "<p> Vous utilisez {$tab2[ 'deux' ] } <br />"; 
define("CTE","lang");//Crée la constante CTE 
$tab2["lang"] = " PHP ET MySQL"; 
$tab2[CTE] = " ASP.NET"; 
$tab2["CTE"] = "JAVA"; 

echo "Le nombre d'éléments est ", count($tab2) , "<br />"; 

echo "L'élément \$tab2[\"CTE\"] vaut " .$tab2["CTE"] , "<br / >"; 

echo "L'élément \$tab2[CTE] vaut " .$tab2[CTE] ."<br />"; 

echo "<p> Le langage préféré de 1 _ Open source est{$tab2["l ang"] ) <br />"; 

?> 

Le script retourne le résultat suivant : 



Vous utilisez PHP 

Le nombre d'éléments est 5 

L'élément $tab2["CTE"] vaut JAVA 

L'élément $tab2[CTE] vaut ASP.NET 

Le langage préféré de l'Qpen source est ASP.NET 
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Remarquez que la dernière ligne ne correspond pas du tout à vos attentes, pas plus 
d'ailleurs qu'à la réalité. 



Attention 

Les clés des tableaux associatifs étant sensibles à la casse, 

$tab["cle"] 
est différent de 

$tab["CLE"] 

De plus, les chaînes définissant les clés ne doivent pas comporter d'espaces. 



L'exemple 2-3 crée dynamiquement une liste de liens à partir des valeurs des éléments 
d'un tableau associatif. Dans la pratique, les valeurs des éléments du tableau devraient 
provenir d'une base de données pour que la page soit réellement dynamique. Les liens 
sont affichés dans un liste à puces créée avec les balises HTML <ul> et <li>, auxquelles 
est appliqué un style CSS défini dans l' en-tête du document. 

<^ Exemple 2-3. Utilisation des tableaux 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset^i so-8859-r' /> 

<title>Les tableaux</title> 

<style type="text/css"> 

ul {1 ist-style-image:url ( "etoi 1 e.gif " ) ; } 

</style> 

</head> 

<body> 

<?php 

//création des éléments du tableau 
$tab["php"] = "php.net": 
$tab["mysql "] = "mysql.com"; 
$tab["xhtml "] = "w3.org": 
//création des liens 
echo"<h2> Mes liens préférés </h2>": 

echo "<ul><li><a href=\" http://www.{$tab['php']}\" title=\"Le site php.net\"> 
^&nbsp: PHP </a> </li>": 

echo "<li><a href=\" http://www.{$tab['mysql '])\" title=\"Le site mysql.com\"> 
^&nbsp: MySQL </a> </li>": 

echo "<li><a href=\" http://www.{$tab['xhtmr]}\" title=\"Le site du W3C\"> 

*»  XHTML </a> </li></ul>": 

?> 

</body> 
</html> 



Le script affiche le résultat illustré à la figure 2-1. 
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Figure 2-1 

Création dynamique de liens 

Comme les chaînes, les tableaux offrent de nombreuses possibilités de manipulation des 
données. PHP fournit en standard un grand nombre de fonctions spécialisées permettant 
d'améliorer cette gestion. Elles seront abordées en détail au chapitre 5. 



Les objets 

PHP permet l'utilisation des classes et utilise le type object pour toute variable créée en 
tant qu'instance d'une classe. Nous reviendrons plus en détail sur les notions de classe et 
d'objet au chapitre 9. 

La version 5 de PHP offre un éventail beaucoup plus large et rigoureux que PHP 4 de 
possibilités de programmation objet. 

Le script suivant : 

<?php 

class myclass{ 

//définition de la classe (ici elle est vide) 
} 

$varcl = new myclass; <— O 

echo "Le type de la variable \$varcl est : " ,gettype($varcl ) ; <— © 
?> 

crée une classe nommée mycl ass puis une variable $varcl à l'aide de l'opérateur particu- 
lier new (repère O)- 

La ligne suivante (repère ©) affiche : 



Le type de la variable $varcl est : object 



Vous venez de créer une variable d'un type nouveau. 
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Les types divers 

PHP offre également deux types particuliers qui sont utilisés dans des circonstances bien 
définies. 

Le type resource 

Le type resource représente une référence à des informations présentes sur le serveur. Il 
est le type retourné par certaines fonctions particulières. C'est le cas, entre autres, des 
fonctions utilisées pour accéder à une base de données lors de la connexion, qui retour- 
nent une valeur de type resource. Cette dernière permet d'identifier chaque connexion 
initiée par un utilisateur puis est utilisée pour retourner les données après interrogation 
de la base par l'utilisateur concerné. Cet identifiant trouve toute son utilité quand il y a 
plusieurs connexions simultanées sur une même base, notamment à partir d'un même 
script. 

L'exemple suivant réalise une connexion au serveur MySQL à l'aide de la fonction 
mysql„connect( ) et récupère un identifiant de connexion $connect, qui est la valeur retour- 
née par cette fonction. Il affiche ensuite la valeur puis le type de cette variable. 

<?php 

type pg3Qypce*************** 
$connect = mysql_connect("localhost","root","") or die ("ERREUR de CONNEXION"); 
echo "L'identifiant de connexion vaut : Sconnect <br />"; 
echo "Le type de la variable \$connect est " ,gettype($connect) ; 
?> 

Le script affiche le résultat suivant : 



L'identificateur de connexion vaut : Resource id #1 
Le type de la variable $connect est resource 



La lecture de la valeur de la variable Sconnect n'a pas d'intérêt particulier une fois la 
connexion réalisée, mais sa récupération permet d'accéder à la base de données. Pour 
plus de détails, voir le chapitre 15, consacré à l'accès aux bases de données MySQL. 

Le type NULL 

Le type NULL, ou nul 1 , est celui qui est attribué à une variable qui n'a pas de contenu ou 
qui a été explicitement initialisée avec la valeur NULL. Aussitôt qu'une valeur légale est 
donnée à la variable, elle prend le type correspondant. 

Attention : NULL et zéro 

Une variable contenant uneciiaîne vide ou ia vaieur "0" n'a pas ie type NULL mais string. De même, une 
variable contenant la valeur 0 est du type i nteger. 



Variables, constantes et types H 
Chapitre2^^ 

Dans le code suivant, le code de création de la variable $varvide (repère O) est déconseillé 
dans un script, car il génère un avertissement. De même, l'utilisation de cette variable par 
l'instruction echo est à proscrire. 

<?php 

f ^■k-k-k-k-k-k-k-k'k-k-k'k-k-k-k'jQ typG N U L L**************************** 

Svarvide; O 

echo "La variable vide vaut : $varvide <br />"; 

echo "Le type de la variable \$varvide est " ,gettype($varvide) , " <br />"; 
$varvide="" ; 

echo "La variable vide vaut : $varvide <br />"; 

echo "Le type de la variable \$varvide est " ,gettype($varvide) ; 

?> 

Le code affiche le résultat suivant : 



La variable vide vaut : 

Le type de la variable Svarvide est NULL 

La variable vide vaut : 

Le type de la variable $varvide est string 



Mémo des fonctions 

boolean define(string nom_cte, valeur [,bool casse]) 

Crée la constante nom_cte et lui attribue une valeur. Le paramètre casse indique que le nom de la constante est insen- 
sible à la casse (TRUE) ou non. 

boolean defined(string nom_cte) 

Retourne TRUE si la constante nom_cte existe et FALSE dans le cas contraire. 

string gettype($nom_var) 

Retourne le type de la variable $noin_var. 

boolean eiiipty($noiii_var) 

Retourne TRUE si la variable $nom_var n'est pas affectée ou a une des valeurs NULL, 0 ou "0" et FALSE dans le cas 
contraire. 

boolean isset($noiii_var) 

Retourne TRUE si la variable $nom_var existe et est définie avec une valeur différente de NULL. 
array get_defined_constants( ) 

Retourne un tableau contenant toutes les constantes prédéfinies et celles qui ont été créées dans le script, 
boolean settype($var, string type) 

Effectue le transtypage de $var dans le type précisé. Retourne TRUE si l'opération est réussie et FALSE dans le cas 
contraire. 
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boolean is_array($var) 

boolean is_bool ($var) 

boolean is_double($var) 

boolean is_integer($var) 

boolean isjul 1 ($var) 

boolean is_object($var) 

boolean is_resource($var) 

boolean is_string($var) 

Ces fonctions retournent TRUE si la variabie est du type testé et FALSE dans le cas contraire. 

Exercices 

Exercice 1 

Parmi les variables suivantes, lesquelles ont un nom valide : mavar, $mavar, $var5, $_ 
mavar, $_5var, $ élémentl, $hotel4* ? 

Exercice 2 

Donnez les valeurs de $x, $y, $z à la fin du script suivant : 

$x="PostgreSQL": 
$y="MySQL": 
$z=&$x: 
$x="PHP 5"; 
$y=&$x: 

Exercice 3 

Lisez les valeurs des variables du script de l'exercice 2 à l'aide du tableau SGLOBALS. 
Exercice 4 

Déterminez le numéro de version de PHP, le nom du système d'exploitation de votre 
serveur ainsi que la langue du navigateur du poste client. 

Exercice 5 

Donnez la valeur de chacune des variables pendant et à la fin du script suivant, et vérifiez 
l'évolution du type de ces variables : 

$x="PHP5": 
$a[]=&$x: 

$y=" 5 eme version de PHP"; 

$z=$y*10: 

$x.=$y : 

$y*-$z: 

$a[0]="l^ySQL": 
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Exercice 6 

Donnez la valeur des variables $x, $y, $z à la fin du script : 

|$x="7 personnes"; 
$y=(integer) $x; 
$x="9E3"; 
$z=(double) $x: 

Exercice 7 

Donnez la valeur booléenne des variables $a,$b,$c,$d,$eet$f: 

$a="0": 
$b="TRUE": 
$C=FALSE; 
$d=($a OR $b): 
$e=($a AND $c); 
$f=($a XOR $b): 
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On retrouve dans PHP la plupart des instructions de contrôle des scripts. Indispensables 
à la gestion du déroulement d'un algorithme quelconque, ces instructions sont présentes 
dans tous les langages. PHP utilise une syntaxe très proche de celle du langage C. 

Ceux qui ont déjà pratiqué un langage tel que le C ou plus simplement JavaScript seront 
en pays de connaissance. Pour les autres, une adaptation sera sans doute nécessaire. La 
version 5 de PHP a vu l'apparition de nouvelles instructions dédiées à la gestion des 
exceptions, comme try...catch ou throw, qui lui faisaient défaut jusqu'à présent. 



Les Instructions conditionnelles 

Comme tout langage, PHP dispose d'instructions conditionnelles qui permettent d'orien- 
ter le déroulement d'un script en fonction de la valeur de données. 



Linstruction if 

L'instruction if est la plus simple et la plus utilisée des instructions conditionnelles. 
Présente dans tous les langages de programmation, elle est essentielle en ce qu'elle permet 
d'orienter l'exécution du script en fonction de la valeur booléenne d'une expression. 

Sa syntaxe est la suivante : 

I if (expression) instruction; 

Si l'expression incluse dans les parenthèses est évaluée à la valeur booléenne TRUE, 
l'instruction qui suit est exécutée. Dans le cas contraire, l'exécution passe directement à 
la ligne suivante. 
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L'instruction if peut être suivie d'un bloc d'instructions délimité par des parenthèses qui 
sera entièrement exécuté dans les mêmes conditions : 

if (expression) 
{ 

//bloc de code 
} 

La rédaction de l'expression est importante. Elle peut devenir complexe lorsqu'elle 
comprend des opérateurs logiques associant ses différents composants. 

Dans le code suivant : 

<?php 
$a=6; 

if(is_integer($a) && ($a<10 && $a>5) && ($a%2==0) ) {echo "Conditions satisfaites";) 
?> 

l'expression composée : 

I {is_integer($a) && ($a<10 && $a>5) && ($a^2==0)) 

est évaluée à TRUE si $a répond simultanément aux trois conditions suivantes : être un 
entier, être compris entre 5 et 10 et être divisible par 2, soit pour $a les valeurs possibles 
de 6 et 8 uniquement. Le message ne s'affiche donc que dans ces cas. 

PHP réalise une évaluation booléenne d'un grand nombre d'expressions qui ne contien- 
nent pas en elles-mêmes de variables booléennes. Il admet, par exemple, des expressions 
du genre : 

|$a = 25; 
if($a) {echo "La condition est vraie <br />";} 

Dans ce cas, ce n'est pas la valeur de la variable $a qui est prise en compte mais son 
évaluation booléenne, qui vaut TRUE. Nous avons déjà abordé ce point au chapitre 2. Le 
lecteur pourra se reporter au tableau 2-6 pour revoir les conditions d'évaluation dans les 
différents cas. 



Ne pas se tromper d'opérateur 

Une erreur courante consiste à confondre l'opérateur de comparaison == avec l'opérateur d'affectation =. 
Dans les expressions conditionnelles, pour tester l'égalité de deux valeurs il faut employer l'opérateur == 
ou encore === pour tester l'identité (même valeur et même type). 



Linstruction if...else 

L'instruction i f . . . el se permet de traiter le cas où l'expression conditionnelle est vraie et 
en même temps d'écrire un traitement de rechange quand elle est évaluée à FALSE, ce que 
ne permet pas une instruction if seule. L'instruction ou le bloc qui suit else est alors le 
seul à être exécuté. L'exécution continue ensuite normalement après le bloc el se. 
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L'exemple 3-1 suivant calcule le prix net après une remise variable en fonction du 
montant des achats selon les critères suivants : 

• Si le prix total est supérieur à 100 euros, la remise est de 10 %. Cette condition est 
traitée par l'instruction i f (repère Q)- 

• Pour les montants inférieurs ou égaux à 100 euros, la remise est de 5 %. Cette condi- 
tion est traitée par l'instruction el se (repère ©). 

'•^ Exemple 3-1. L'instruction if...else 

<?php 
$prix=55; 

if($prix>100) <-0 
{ 

echo "<b>Pour un montant d'achat de $prix €, la remise est de 10 % </b> 
^<br />": 

echo "Le prix net est de " ,$prix*0.90; 

} 

else <— 0 
{ 

echo "<b>Pour un montant d'achat de $prix &euro:, la remise est de 5 %</b><br />"; 
echo ''<h3>Le prix net est de " ,$prix*0.95, ''</h3>" ; 

} 

?> 

Compte tenu de la valeur attribuée ici à la variable $a, le script affiche le résultat suivant : 



Pour un montant d'achat de 55 n, la remise est de 5 % 
Le prix net est de 52.25 n 



Le bloc qui suit les instructions if ou else peut contenir toutes sortes d'instructions, y 
compris d'autres instructions if... else. Nous obtenons dans ce cas une syntaxe plus 
complexe, de la forme : 

if (expressionl) 
{//Bloc 1) 
e1seif(expression2) 
{//Bloc 2) 
el se 

{//Bloc 3) 

Cette construction s'interprète de la façon suivante : si l'expression 1 est évaluée à TRUE, 
le bloc 1 est exécuté ; dans le cas contraire, si l'expression 2 qui suit l'instruction elseif 
est évaluée à TRUE, le bloc 2 est exécuté. Dans les autres cas, c'est le bloc 3 qui est 
exécuté. Quelle que soit la situation, un seul bloc est exécuté. 

Dans l'exemple 3-11, vous voulez afficher le montant d'une remise calculée selon les 
modalités suivantes : 

• Si vous achetez un PC de plus de 1 000 euros, la remise est de 15 %. 
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• Pour un PC de 1 000 euros et moins, la remise est de 10 %. 

• Pour les livres, la remise est de 5 %. 

• Pour tous les autres articles, la remise est de 2 %. 

La première instruction if...el seif...el se (repères Q' 0 ^t 0) contrôle la catégorie du 
produit. La deuxième instruction i f...el se détermine le montant de la remise si le produit 
est un PC (repères Q et 0). L'indentation du code permet une lecture plus facile. Faute 
d'une telle indentation, il est difficile de distinguer à quelle instruction i f se rapporte une 
instruction el se. 

Exemple 3-2. Les instructions if imbriquées 

<?php 

// -k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k^f elSClf g ] 5 9************** ** 

$cat="PC": 
$prix=900: 

if($cat=="PC") <-0 
{ 

if($prix 1000) <-© 
{ 

echo "<b>Pour l'achat d'un PC d'un montant de $prix €. la remise est de 
^•15 %</b><br />": 

echo "<h3> Le prix net est de : '',$prix*0.85, "Xeuro; </h3>''; 

) 

else <— 0 
{ 

echo ''<b>Pour l'achat d'un PC d'un montant de $prix €, la remise est de 
^10 %</b><br />"; 

echo ''<h3> Le prix net est de : " .$prix*0.90, "&euro: </h3>'': 

} 

} 

elseif($cat==''Livres'') <— 0 
{ 

echo "<b>Pour l'achat de livres la remise est de 5 %</ bXbr />"; 
echo "<h3> Le prix net est de : " ,$prix*0.95, "€ </h3>"; 

} 

else <— 0 
{ 

echo''<b>Pour les autres achats la remise est de 2 %</ bXbr />"; 
echo "<h3> Le prix net est de : " ,$prix*0.98, "ieuro; </h3>": 

} 

?> 

Le résultat de ce script pour $cat à la valeur "PC" et la variable $prix à la valeur 900 donne 
l'affichage suivant : 



Pour l'achat d'un PC d'un montant de 900 n. la remise est de 10 % 
Le prix net est de : 810n 
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Lopérateur ? 

L'opérateur ? permet de remplacer avantageusement une instruction if...else en 
évaluant une expression et en attribuant à une variable une première valeur si la condition 
est vraie ou une autre valeur si elle est fausse. 

Sa syntaxe est la suivante : 

I $var = expression ? valeurl : valeur2 

Elle est équivalente à : 

Iif(expression) {Svar^valeurl;} 
else {$var=valeur2:} 

Le premier exemple de calcul de remise pourrait s'écrire : 

ISvar = ($prix>100)? "la remise est de 10 %":"la remise est de 5 %" ; 
echo "<b>Pour un montant d'achat de $prix €: $var </b><br />"; 

au lieu de : 

if($prix>100) 
{ 

echo "<b>Pour un montant d'achat de $prix Sieuro;, la remise est de 10 ^</b><br />"; 

} 

el se 
{ 

echo ''<b>Pour un montant d'achat de $prix &euro:, la remise est de 5 %</b><br />"; 

} 

Cet opérateur est généralement employé avec des expressions booléennes courtes. 
L'exemple 3-3 adapte un texte en fonction de la valeur d'une variable, soit pour une 
formule de politesse en fonction du sexe du visiteur, soit pour mettre au pluriel un mot en 
fonction d'un nombre. 

f*' Exemple 3-3. L'opérateur ? 

<?php 

$ch = "Bonjour "; 
$sexe="M" : 

$ch ($sexe=="F" )?"Madame" : "Monsieur" : 
echo "<h2>$ch</h2>"; 
$nb = 3; 

$pmu ="I1 faut trouver ".$nb; 

$mot = ($nb==l)?" cheval":" chevaux": 

echo "<h3> $pmu $mot </h3>"; 

?> 

Compte tenu des valeur des variables $sexe et $nb le résultat retourné est le suivant : 



Bonjour Monsieur 

Il faut trouver 3 chevaux 
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Lînstruction switch...case 

Supposez que vous vouliez associer un code de département avec son nom réel. Avec une 
suite d'instructions if, vous écririez le script suivant : 

<?php 
$clept=75: 

if ($dept==75) echo "Paris"; 

if ($dept==78) echo "Hauts de Seine"; 

if ($dept==91) echo "Yvelines"; 

if ($dept==93) echo "Seine Saint Denis"; 

?> 

dans lequel la variable $dept proviendrait d'un formulaire, par exemple. 

Ce code peut être simplifié sans multiplier les instructions if grâce à l'instruction 
switch. . .case. Cette dernière permet de comparer la valeur d'une expression avec une 
liste de valeurs prédéterminées par le programmeur et d'orienter le script en fonction de 
la valeur de cette expression. 

La syntaxe de cette instruction est la suivante : 

switch(expression) 
{ 

case valeurl: 
//bloc d'instructions 1; 
break; 

case valeur2: 
//bloc d'instructions 2; 
break; 



case valeurN: 
//bloc d'instructions N; 
break; 

default: 

//bloc d'instructions par défaut; 
break; 

} 

Si l'expression qui suit le mot-clé switch vaut valeurl, les instructions qui suivent la 
première instruction case sont exécutées, après quoi l'exécution passe à la fin du bloc 
switch. Il en va de même pour les valeurs suivantes. Si aucune concordance n'est trouvée, 
ce sont les instructions qui suivent l'instruction default qui sont exécutées. 

La présence de cette instruction n'est pas obligatoire, mais elle est conseillée pour faire 
face à toutes les éventualités, telles les erreurs de saisie, par exemple. Chaque groupe 
case doit se terminer par une instruction break, faute de quoi les autres blocs case sont 
aussi exécutés. 

La valeur qui suit chaque instruction case peut être une constante littérale ou une 
constante nommée, déclarée précédemment à switch à l'aide du mot-clé défi ne. 
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Plusieurs instructions case différentes peuvent se succéder avant qu'intervienne un bloc 
d'instructions (voir repère O dans l'exemple 3-4). Dans ce cas, les différentes valeurs 
indiquées déclenchent l'exécution du même code (repère ©). 

Le script précédent devient celui de l'exemple 3-4. 
'•^ Exemple 3-4. L'instruction switch...case 

<?php 
$dept=75; 
switch($dept) 
{ 

//Premier cas 

case 75: <— O 

case "Capital e" : <—0 

echo "Paris" ; <— 0 

break; 

//Deuxième cas 
case 78: 

echo "Hauts de Seine"; 
break; 

//Troisième cas 
case 93: 

case "Stade de france": 
echo "Seine Saint Denis"; 
break; 

//la suite des départements... 

//Cas par défaut 

default: 

echo "Département inconnu en Ile de France"; 

break; 

} 

?> 



Les instructions de boucle 

Les boucles permettent de répéter des opérations élémentaires un grand nombre de 
fois sans avoir à réécrire le même code. Selon l'instruction de boucle utilisée, le 
nombre d'itérations peut être défini à l'avance ou être déterminé par une condition 
particulière. 



La boucle for 

Présente dans de nombreux langages, la boucle for permet d'exécuter plusieurs fois la 
même instruction ou le même bloc sans avoir à réécrire les mêmes instructions. Sa 
syntaxe est la suivante : 
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for(expressionl; expressionZ; expressions) 
{ 

//instruction ou bloc; 
} 

expressionl est toujours évaluée. Il s'agit généralement de l'initialisation d'une ou 
plusieurs variables servant de compteur pour la boucle. expression2 est ensuite évaluée 
avec une valeur booléenne : si elle vaut TRUE, la boucle continue et les instructions 
comprises dans le bloc sont exécutées, sinon la boucle s'arrête. Si elle est toujours vraie 
on obtient une boucle infinie, vérifiez donc qu'elle peut être fausse, expressions n'est 
exécutée qu'à la fin de chaque itération. Il s'agit le plus souvent d'une instruction 
d'incrémentation de la variable compteur. 

L'exemple 3-5 crée un document qui affiche six niveaux de titre utilisant les balises <hl> 
à <h6> en deux lignes de code seulement. 

Exemple 3-5. Une boucle for simple 

<?php 

for($i=l:$i<7:$i-i-i-) 

{ 

echo "<h$i> $i iTitre de niveau $i </h$i>"; 
} 

?> 

Le résultat de la boucle est illustré à la figure 3-1. 
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Figure 3-1 

Création de titres 



Les trois expressions utilisées dans la boucle for peuvent contenir plusieurs parties sépa- 
rées par des virgules. La boucle peut en ce cas être réalisée sur plusieurs variables, 
comme illustré à l'exemple 3-6. 
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f*' Exemple 3-6. Une boucle à plusieurs variables 

<?php 

for($i=l,$j=9:$i<10,$j>0:$i++.$j--) 
//$i varie de 1 à 9 et $j de 9 à 1 
{ 

echo "<span style=\"border-style:double;border-width:3;\"> $i + $j=10</span>" ; 
} 

?> 

Le résultat de cette boucle double est la table d'addition de la figure 3-2. 



3 http://127.0.0.1/php5/C3insliuctions/insttuct3.2.php MiciosofI Internet Explorer 
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Table d'addition 

||l + 9 =10||[2 + 8 =10|||T+7 =10|||4 + 6 ^ || 5 + 5 =10||| 6 + 4 =10||| 7 + 3 =10||r8 + 2 =10||| 9 + 1 =10|| 
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Figure 3-2 

Table d'addition créée par une boucle double. 



Les boucles imbriquées 

Il est possible d'imbriquer des boucles for les unes dans les autres sur autant de niveaux 
que désiré, le bloc qui suit la première contenant toutes les autres. Chaque variable comp- 
teur déclarée dans une boucle n'est utilisable que dans la boucle qui la déclare et dans 
celles de niveau inférieur. 

L'exemple 3-7 ci-après crée une table de multiplication dans un tableau XHTML à deux 
dimensions, chaque dimension étant gérée par une variable compteur différente, $i et $j. 
La première boucle for (repère Q) sert qu'à créer la ligne d'en-tête de la table. La 
variable $i est locale à la boucle. Le fait de réutiliser le même nom de variable dans 
la boucle suivante n'a donc aucune importance. 

Deux autres boucles imbriquées sont ensuite utilisées pour créer le corps de la table. La 
première (repère©) itère les numéros de ligne avec la variable $i, et la deuxième 
(repère 0) le contenu des cellules du tableau avec la variable $j . 

f*" Exemple 3-7. Les boucles lor imbriquées 

|<?php 
echo "<h2> Révisez votre table de multiplicationK/ h2>"; 
//Début du tableau HTML 
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echo "<table border=\"2\" style=\"background-color:yellow\"> <th> 

*» X &nbsp:</th>"; 

//Création de la première ligne 

for($i=l:$i<10;$i++) 

{ 

echo "<th>&nbsp:$i&nbsp:</th>"; <— O 
} 

//Fin de la boucle 1 
/ 

//Création du corps de la table 

//Boucles de création du contenu de la table 

for($i=l:$i<10;$i++) <-© 

{ 

//Création de la première colonne 
echo "<tr><th> $i </th>" ; 
//Remplissage de la table 
for($j=l:$j<10:$j++) ^0 
{ 

echo "<td style=\"background-color:red;color:white\">    <b>". $i*$j. 
^"&nbsp:  </td>": 

) 

echo "</b></tr>"; 

} 

echo "</table>" 
?> 

La figure 3-3 présente la table de multiplication créée par ce script. 



Adresse httpc//127.0.ai/k<NiS''C]MiijctiansAii^^ Q OK 




Révisez votre table de multiplication! 
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Figure 3-3 

Notre table de multiplication 

Vous trouverez de nombreux exemples d'utilisation de boucles for tout au long de 
cet ouvrage, notamment au chapitre 5 pour la lecture de l'ensemble des éléments d'un 
tableau. 
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La boucle while 

La boucle for oblige à préciser les valeurs limites pour lesquelles la boucle va s'arrêter. 
A moins d'utiliser une instruction if pour la stopper à l'aide de l'instruction break (voir 
le paragraphe « Sortie anticipée des boucles » dans les sections suivantes), il faut connaître 
ces valeurs limites. La boucle while permet d'affiner ce comportement en réalisant une 
action de manière répétitive tant qu'une condition est vérifiée ou qu'une expression quel- 
conque est évaluée à TRUE et donc de l'arrêter quand elle n'est plus vérifiée (évaluée à 
FALSE). 

La boucle whi 1 e permet, par exemple, d'afficher tous les résultats fournis après interroga- 
tion d'une base de données, sans en connaître à l'avance le nombre exact. La syntaxe de 
cette instruction est la suivante : 

while(expression) 
{ 

//Bloc d'instructions à répéter; 
) 

L'expression précisée doit pouvoir être évaluée de façon booléenne par PHP et pouvoir 
changer de valeur au cours du script, faute de quoi la boucle serait infinie. 

L'exemple suivant : 

|$a = "oui": 
while ($a) (echo $a; } 

constitue une boucle infinie, car $a est évaluée à TRUE en tant que chaîne non vide. 

De même, dans le code suivant : 

|$a = 54; 
while ($a>100) {echo $a; } 

l'instruction echo $a n'est jamais exécutée car l'expression $a>100 contenue dans while 
est toujours fausse. 

L'exemple 3-8 ci-dessous effectue une suite de tirages de nombres aléatoires compris 
entre 1 et 100 grâce à la fonction r a nd () (repère ©), avec comme condition supplémen- 
taire que le nombre tiré soit un multiple de 7 (repère O). Le script affiche les nombres 
tirés jusqu'à trouver un multiple de 7. 

Exemple 3-8. Tirage d'un multiple de 7 avec une boucle while 

<?php 
$n=l; 

while($n^7!=0 ) <-© 
{ 

$n = rand(l.lOO): <-© 
echo $n,"  /"; 
} 

?> 
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Vous obtenez, par exemple, la suite de nombres 72 / 79 / 50 / 95 / 1 1 / 43 / 18 / 49 / (cette 
suite varie évidemment à chaque tirage). 

La boucle do...while 

La boucle do. . .while apporte une précision à la boucle while. Dans celle-ci, en effet, si 
l'expression booléenne est évaluée à FALSE, les instructions qu'elle contient ne sont 
jamais exécutées. Avec l'instruction do. . .while, au contraire, la condition n'est évaluée 
qu'après une première exécution des instructions du bloc compris entre do et whi 1 e. 

La syntaxe de la boucle do...whi 1 e est la suivante : 

do { 

//bloc d'instructions 
} 

while(expression) ; 

Le script de l'exemple 3-9 reprend celui de l'exemple 3-8, mais il n'est plus besoin cette 
fois d'initialiser la variable $i à 1 car la divisibilité par 7 n'est testée qu'après le premier 
tirage (repère O). 

Exemple 3-9. Tirage avec une boucle do. ..while 

<?php 

do 

{ 

$n = randd.lOO): 
echo $n,"  / "; 
} 

while($n%7!=0); <-© 
?> 

Les résultats obtenus sont similaires. 

La boucle foreach 

Introduite à partir de la version 4.0 de PHP, l'instruction foreach permet de parcourir 
rapidement l'ensemble des éléments d'un tableau, ce que fait aussi une boucle for, mais 
foreach se révèle beaucoup plus efficace. 

La boucle foreach est particulièrement efficace pour lister les tableaux associatifs dont il 
n'est nécessaire de connaître ni le nombre d'éléments ni les clés. Sa syntaxe est variable 
selon que vous souhaitez récupérer seulement les valeurs ou les valeurs et les clés (ou les 
indices). 

Pour lire les valeurs seules, la première syntaxe est la suivante : 

foreach($tableaLi as $valeur) 
{ 

//bloc utilisant la valeur de l'élément courant 
} 
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La variable $valeur contient successivement chacune des valeurs du tableau. Il importe 
cependant de ne pas utiliser un nom de variable existant, faute de quoi sa valeur est écrasée. 
Les variables utilisées dans une boucle foreach ne sont pas locales à la boucle et gardent 
donc la valeur du dernier élément lu dans tout le script. 

Pour lire les valeurs et les clés (ou les indices), la deuxième syntaxe est la suivante : 

foreach($tableau as $cle=>$valeur) 
{ 

//bloc utilisant la valeur et la clé de l'élément courant 
} 

Ici, la variable $cl e contient successivement l'indice ou la clé de chacun des éléments du 
tableau dans l'ordre numérique pour les tableaux indicés et dans l'ordre de création des 
éléments pour les tableaux associatifs. La variable $val eur contient la valeur associée à la 
clé ou à l'indice courant. 

Dans ces deux cas, la variable $tableau peut être remplacée par une expression dont la 
valeur est du type array, comme ce pourrait être le cas, par exemple, d'une fonction 
retournant un tableau. Cette instruction est abondamment utilisée pour lire tous les résul- 
tats obtenus après interrogation d'une base de données. 

L'exemple 3-10 crée d'abord un tableau indicé contenant les puissances de 2 à l'aide 
d'une simple boucle for (repère O) puis lit l'intégralité des éléments à l'aide d'une 
boucle foreach (repère 0). 

Exemple 3-10. Lecture des valeurs d'un tableau indicé 

<?php 

//Création du tableau de 9 éléments 

for($i=0;$i<=8;$i-H-) 

{ 

$tab[$i] = pow(2.$i ) ; <— O 

} 

$val ="Une valeur" ; 

echo $val , ''<br />" ; 

//Lecture des valeurs du tableau 

echo"Les puissances de 2 sont :"; 

foreach($tab as $val)<— © 

{echo $val . " : " ; } 

?> 

Le résultat suivant est affiché : 



Les puissances de 2 sont : 1 : 2 : 4 : 8 : 16 : 32 : 64 : 128 : 256: 



L'exemple 3-11 lit les indices et les valeurs du même tableau en utilisant la deuxième 
syntaxe (de la forme $tab as $ind=>$val ) pour récupérer les indices dans la variable $i nd 
et les valeurs dans $val (repère Q)- H sst possible de vérifier que les variables $1nd et $val 
sont toujours visibles à l'extérieur de la boucle en affichant leurs valeurs après la fin de la 
boucle foreach (repère 0). 
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'■^ Exemple 3-1 1 . Lecture des indices et des valeurs 

<?php 

//Création du tableau 

for($i=0:$i<=8;$i++) 

{ 

$tab[$i] = pow(2,$i ); 

} 

//Lecture des indices et des valeurs 

foreach($tab as $ind=>$val ) <— © 

{echo " 2 puissance $ind vaut $val <br />";} 

echo "Dernier indice ",$ind, " .dernière valeur ",$val;<— © 

?> 

L'exemple affiche la liste suivante : 



Z puissance 0 vaut 1 
2 puissance 1 vaut 2 



2 puissance 7 vaut 128 
2 puissance 8 vaut 256 
Dernier indice 8 .dernière valeur 256 



L'exemple 3-12 crée un tableau associatif dont les clés sont des identifiants de clients et 
associe à chacun un code aléatoire compris entre 100 et 1 000 (repère O) puis lit et affiche 
les clés et les valeurs du tableau (repère 0). 

f*' Exemple 3-1 2. Lecture des clés et des valeurs 

<?php 

//Création d'un tableau associatif 

for($i=0:$i<=8;$i++) 

{ 

$tabass["client".$i] = rand(lOO.lOOO) ; <— 0 

} 

//Lecture des clés et des valeurs 
foreach($tabass as $cl e=>$val ) <— © 

{echo " Le client de login <b>$cle</b> a le code <b>$val</b><br />":) 
?> 

Les résultats suivants sont affichés : 



Le client de login clientO a le code 638 
Le client de login clientl a le code 569 



Le client de login client6 a le code 135 
Le client de login client? a le code 786 
Le client de login client8 a le code 406 
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foreach et les objets 

Depuis PHP 5, vous pouvez lire l'ensemble des noms et des valeurs des propriétés d'un objet à l'aide 
d'une boucle foreach comme nous le faisons pour un tableau. Vous rencontrerez aux chapitres 9, 16 et 
17 des illustrations de ce type de lecture. 



Sortie anticipée des boucles 

Vous pouvez avoir besoin d'arrêter une boucle avant son terme normal. Pour cela, vous 
disposez des instructions break et continue, qui permettent de réaliser un arrêt partiel ou 
total. 

L'Instruction break 

Il est possible d'arrêter complètement une boucle for, foreach ou while avant son terme 
normal si une condition particulière est vérifiée, à l'aide de l'instruction break. Le script 
n'est pas arrêté, comme avec l'instruction exit, et seule la boucle en cours se termine. 

Si plusieurs boucles sont imbriquées, seule celle qui contient l'instruction break se 
termine. Pour arrêter plusieurs boucles en même temps, on emploie la syntaxe suivante : 

I break n; 

dans laquelle n désigne le nombre de boucles les plus internes que vous souhaitez fermer. 
Celles de niveau supérieur à n continuent à s'exécuter normalement. 

L'exemple 3-13 crée un tableau de noms (repère O), puis une boucle for lit le tableau 
(repère 0). Cette boucle contient une instruction i f qui vérifie que le nom commence 
par la lettre A (repère 0). Si la condition est remplie, le script affiche le nom. La boucle 
est fermée grâce à une instruction break (repère ©). 



La notation $tab[$i][0] 

La notation $tab[$1][0] permet de récupérer la première lettre de la chaîne de caractères contenue 
dans la variable $tab[$1], $tab[$i ][1] la deuxième lettre, et ainsi de suite. 



La fonction count($tab) 

La fonction count($tab) retourne le nombre d'éléments du tableau $tab, ce qui permet de connaître le 
nombre maximal d'itération de la boucle. Cette expression pourrait être supprimée car c'est l'instruction 
break qui met fin à la boucle. Il est toutefois préférable de l'utiliser pour arrêter la boucle, car si le tableau 
ne contient aucun nom commençant par la lettre A, vous avez une boucle infinie, ce que le serveur 
n'appréciera pas. 
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'•^ Exemple 3-13. L'instruction break 

<?php 

//Création d'un tableau de noms <— 

$tab[l]="Basile": 

$tab[2]="Conan"; 

$tab[3]="Albert": 

$tab[4]="Vincent": 

//Boucle de lecture du tableau 

for($i=l:$i<count($tab) :$!++) <-© 

{ 

if ($tab[$i][0]=="A") <-© 
{ 

echo "Le premier nom commençant par A est le n' $i: ",$tab[$i]; 
break; <— O 

) 

} 

?> 

L'instruction continue 

A la différence de l'instruction break, l'instruction continue n'arrête pas la boucle en 
cours mais seulement l'itération en cours. La variable compteur est incrémentée immédia- 
tement, et toutes les instructions qui suivent le mot-clé continue ne sont pas exécutées lors 
de l'itération en cours. 

L'exemple 3-14 donne deux illustrations de ce mécanisme : 

• La première utilise une boucle for pour afficher tous les nombres de 1 à 20, à l'excep- 
tion des multiples de 5 grâce au code if ($i%5==0) { continue;} (repère O). 

• La deuxième utilise une boucle foreach qui parcourt un tableau de départements et 
permet de n'afficher que ceux qui commencent par la lettre E (repère 0). 

<^ Exemple 3-14. Interruption partielle d'une boucle 

<?php 

//Interruption d'une boucle for 

for($i=0:$i<20;$i++) 

{ 

if($i^5==0) { continue;) <—0 
echo $i , ''<br />" ; 

} 

//Interruption d'une boucle foreach 

$tab[l]="Ain"; 

$tab[2]="Allier"; 

$tab[27] = ''Eure"; 

$tab[28]="Eure et Loir"; 

$tab[29]="Finistère"; 

$tab[33]="Gi ronde"; 

foreach($tab as $cl e=>$val eur) 
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{ 

if($tab[$cle][0]! = "E") { continue;}^© 

echo "code $cle : département ",$tab[$cle],"<br />"; 

} 

?> 

Le résultat affiché par cet exemple est le suivant : 



1 : 2 : 3 : 4 : 6 : 7 : 8 : 9 : 11 : 12 : 13 : 14 : 16 : 17 : 18 : 19 : 

code 27 : département Eure 

code 28 : département Eure et Loir 

De même que pour l'instruction break, si plusieurs boucles sont imbriquées, il est possible 
d'interrompre les n boucles les plus internes en utilisant la syntaxe suivante : 

" continue N 

Cette possibilité est illustrée à l'exemple 3-15, qui contient trois boucles for imbriquées 
(repères Q' 0 ^t ©). La plus interne contient une instruction i f qui stoppe les itérations 
en cours pour les trois boucles si la somme des variables compteur $i, $j et $k est un 
multiple de 3. C'est l'instruction continue 3 (repère©). Si tel est le cas, l'exécution 
passe directement à l'incrémentation de la variable $i, terminant ainsi de manière anti- 
cipée les itérations des trois boucles en cours. 

Exemple 3-15. Interruption de plusieurs boucles 

<?php 

for ($i=0:$i<10;$i++) <-© 
{ 

for ($j=0;$o<10:$j++) ^0 

{ 

for ($k=0:$k<10;$k++) <-© 
{ 

if (($i+$j+$k)X3==0) continue 3; <-© 
echo "$i : $j : $k <br /> 

} 

} 

} 



Gestion des erreurs 

Un bon script ne devrait théoriquement pas générer d'erreur. Certaines erreurs sont inévi- 
tables comme celles qui sont dues à des problèmes de connexion défaillante ou de bogue 
sur le serveur. Nous nous intéressons ici davantage aux erreurs qui peuvent être provo- 
quées par des actions de l'utilisateur comme des saisies erronées qui provoquent l'arrêt 
du script ou encore à celles qui peuvent survenir lors de la tentative d' accès à une ressource 
inexistante. 

La gestion des erreurs a pour but de signaler « proprement » les problèmes au visiteur et 
d'éviter l'affichage des messages d'erreur bruts tels que PHP les envoie au navigateur. 
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Suppression des messages d'erreur 

Si vous écrivez le code ci-dessous : 

<?php 

$a=10: 

$b=0: 

echo $a/$b; <— Q 

fopenC "inconnu. txt" , "r" ) : <— 0 

?> 

les messages suivants apparaissent : 

" Warning: Division by zéro in c:\wamp5\www\php5\c3instructions\instruct3.15i.php 
I ^on line 4 

Warning: fopen(inconnu.txt) [function.fopen]: failed to open stream: No such file or 
^directory in c:\wamp5\www\php5\c3instructions\instruct3.15a.php on line 5 

Le premier message correspond à la division par 0 (repère O), et le second à la tentative 
d'ouverture d'un fichier qui n'existe pas (repère 0). Ces messages affichés dans le cours 
d'une page HTML sont du plus mauvais effet pour les visiteurs du site. 

Pour éviter l'affichage des messages d'erreur de PHP dans le navigateur, il existe les 
moyens élémentaires suivants : 

• Faire précéder l'appel d'une fonction du caractère @ en écrivant par exemple 
@fopen( "inconnu .txt" . "r" ). 

• Utiliser la fonction error„reporting( ), qui permet de n'afficher que certains messages 
selon le type d'erreur. Sa syntaxe est int error_reporting ( [int niveau] ). C'est le 
paramètre niveau qui permet de choisir le niveau d'affichage des messages d'erreur. 
Ses principales valeurs sont indiquées au tableau 3-1. Vous pouvez combiner plusieurs 
valeurs avec l'opérateur |, comme dans le code suivant : 

I error_reporting(E_WARNING | E_PARSE) ; 

qui permet de n'afficher que les alertes et les erreurs de syntaxe. Pour bloquer tous les 
messages d'erreur, il faut passer à la fonction le paramètre 0. Cette fonction doit être 
utilisée dès le début du script. 



Tableau 3-1 - Liste des niveaux d'erreur courants 



Constante 


Valeur 


Niveau d'affichage 


E_ERROR 


1 


Erreur fatale qui provoque l'arrêt du script, par exempie, l'appel d'une fonction qui 
n'existe pas. 


E_WARNING 


2 


Avertissement ne provoquant pas l'arrêt du script, par exemple, une division par 0. 


E_PARSE 


4 


Erreur de syntaxe détectée par l'analyseur PHP et provoquant l'arrêt du script, par 
exemple l'oubli du point-virgule en fin de ligne. 


E_NOTICE 


8 


Avis que le script a rencontré un problème simple qui peut ne pas être une erreur. 


E_ALL 


4095 


Toutes les erreurs 
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Il est évident que pendant la phase de développement des scripts, ces méthodes doivent 
être désactivées pour permettre au programmeur d'être alerté sur les causes et la localisa- 
tion des erreurs. 



Gestion des exceptions 

Une exception est un mécanisme qui permet d'intercepter une erreur générée par un 
script et de déclencher une action en réponse à cette erreur. Si PHP 4 ne permettait pas 
d'effectuer une gestion des exceptions, la version 5 fournit un mécanisme qui permet de 
gérer les conséquences d'une erreur. 

La classe Exception 

Si vous n'êtes pas familiarisé avec les notions de classe ou d'objet, ainsi que de propriété 
et de méthode, reportez vous au chapitre 9 pour acquérir ces quelques notions de base. 

PHP 5 introduit la classe prédéfinie Exception qui offre une gestion évoluée des excep- 
tions. 

Gérer une exception consiste à délimiter un ou des blocs de code et à prévoir une action 
particulière qui doit être réalisée dans le cas où l'erreur prévue se produit. Ces blocs consti- 
tuent les gestionnaires d'exception. Pour les créer, procédez de l'une des façons suivantes : 

• Créez un bloc à l'aide de l'instruction try qui délimite le code dans lequel peut surve- 
nir une erreur. Il peut s'agir, par exemple, du code qui gère les saisies faites par des 
utilisateurs dans un formulaire (voir le chapitre 6). Ce bloc contient une instruction 
throw pour déclencher l'exception en créant un objet de type Excepti on à l'aide du mot- 
clé new. 

• Créez un bloc à l'aide de l'instruction catch associée au bloc try précédent. Il 
comporte le code qui va gérer l'erreur si elle se produit. C'est ce bloc qui utilise l'objet 
Exception créé par l'instruction throw. Si aucune erreur ne se produit dans le bloc try, 
l'objet Exception n'est pas créé, et le code du bloc catch est ignoré. L'exécution se 
poursuit dans tous les cas après le bloc catch. 

Un gestionnaire d'exception a donc le structure suivante : 

try 

{ 

//Code à surveiller 

If (erreur prévue){throw new Except1on( ) ; } 
else{// Résultat;} 

} 

catchC Exception Sexcept) 
{ 

//Gesti on de 1 ' erreur 

} 

Le nom de l'objet utilisé dans l'instruction catch est sans importance. Un même script 
peut comporter autant de bloc try...catch que vous voulez. Il est également possible 
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d'imbriquer des blocs try les uns dans les autres, à condition que chacun ait un bloc catch 
associé. 

Le constructeur de l'objet Exception créé dans l'instruction throw reçoit deux paramètres, 
correspondant aux propriétés message et code de l'objet. Le premier est une chaîne conte- 
nant le message d'erreur et le second un entier qui définit un code d'erreur facultatif. Cet 
objet est utilisé dans le bloc catch en appelant ses méthodes pour afficher des informa- 
tions sur l'exception. Le tableau 3-2 donne la liste et le rôle des méthodes de l'objet 
Exception. 



Tableau 3-2 - Les méthodes de l'objet Exception 



Méthode 


Définition 


constructC ) 


Constructeur de l'objet. Il est appelé automatiquement lors de la création d'un objet avec le 
mot-clé new. Il définit les propriétés message et code de l'objet. Cette méthode ne doit pas 
être appelée explicitement. 


getMessageC ) 


Retourne la valeur de la propriété message dans une chaîne. 


getCode( ) 


Retourne la valeur de la propriété code sous la forme d'un entier. 


getFileO 


Retourne la valeur de la propriété fi 1 e qui contient le nom et le chemin d'accès du fichier 
dans lequel s'est produite l'erreur. 


getLine( ) 


Retourne la valeur de la propriété 1 i ne qui indique le numéro de ligne à laquelle a été créée 
l'exception. 


toString( ) 


Retourne une chaîne contenant toutes les informations sur l'exception. 



L'exemple 3-16 présente une première mise en œuvre du mécanisme des exceptions et 
des méthodes ci-dessus. Vous y définissez deux variables dans le but d'afficher le résultat 
de la division (repères O ^t ©). Ces valeurs proviendraient en pratique des saisies d'un 
utilisateur. L'absence de gestion de l'erreur provoquerait l'affichage d'une alerte 
{Warning). Supprimer l'affichage de cette alerte en utilisant la fonction error_ 
reporting( ) avec le paramètre 0 laisserait l'utilisateur dubitatif car le résultat attendu ne 
serait pas affiché, et ce sans aucune explication. 

Vous créez donc un bloc try (repère 0) pour gérer ce type d'erreur. Le contrôle de la 
valeur de la division permet de déclencher une exception en définissant un message 
approprié et un code d'erreur (repère ©). Si la valeur de $b était valide, le résultat de la 
division serait affiché normalement, et le bloc catch serait ignoré (repère 0). 

Comme ici $b vaut 0, le bloc catch (repère ©) affiche successivement le message 
d'erreur (repère Q), le nom du fichier dans lequel se produit l'erreur (repère 0), la ligne 
de l'instruction throw à laquelle l'objet $except a été créé (repère 0), le code d'erreur 
(repère®) et les informations sur l'exception (repère©). L'affichage du mot "FIN" 
prouve que l'exécution du script continue normalement, que le bloc catch soit exécuté ou 
non (repère ®). 
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Exemple 3-16. Création d'un gestionnaire d'exception 

<?php 

$a=100: <-0 
$b=0; <-0 
try ^0 

{ 

if ($b==0){throw new Exception("Division par 0",7):)<— 0 
else{echo "Résultat de : $a / $b = ",$a/$b:)<— 0 

} 

catch(Exception $except) <— 0 
{ 

echo "Message d'erreur : " , $except->getMessage( ) . "<hr>" ; <— 0 
echo "Nom du fichier : " ,$except->getFi le( ) , "<hr>" ; <— 0 
echo "Numéro de ligne : " ,$except->getLine( ) , "<hr>" ; <— 0 
echo "Code d'erreur : " ,$except->getCode( ) , "<hr>" ; <— © 
echo " toString :",$except-> toString( ) , "<hr>" ; <— 0 

} 

echo "FIN": <-© 
?> 

La figure 3-4 montre le résultat obtenu. 



nie C(tt yie» go EMioo^ loob ^<don Uo^ 



a 1! 



A hap:;/iocatio«/ptip 5panstruaicn; [ jg.seawii] ' 



Message d'erreur :l)ivision par 0 



Nom du fichier :c:\wamp5\www\php5\c3instructions\instruct3.15.php 



Numéro de ligne :6 



Code d'ctTcur :7 



toString exception 'Exception' with message 'Division par 0' in 
c:\wauipJ\www\php5\c3mstructions\instruct3.12.php;6 Stack trace: #0 {main} 



FIN 



-'s^ a \e- lw» 



Figure 3-4 

Affichages créés par l 'objet Exception 



Cet exemple n'a pour but que d'illustrer l'utilisation des méthodes de l'objet Exception. 
En production, vous n'afficheriez pas toutes ces informations, qui n'intéressent pas le 
visiteur. 



68 



PHP 5 



Vous allez donc modifier ce script pour afficher une boîte d'alerte signalant simplement 
le problème à l'utilisateur. L'exemple 3-17 montre les modifications opérées. Dans le 
bloc catch, vous créez une boîte d'alerte utilisant la fonction JavaScript al ert( ), qui affi- 
che uniquement le message et le code d'erreur (repère O). 

'•^ Exemple 3-1 7. Affichage pour le visiteur 

<?php 
$a=10: 
$b=0: 
try 

{ 

if($b==0) {throw new ExceptionC'Division par 0",7);} 
else{echo "Résultat de : $a / $b = ",$a/$b:} 

} 

catch( Exception Sexcept) 
{ 

echo "<script type=\"text/javascript\"> alerte ' Erreur n' 

^".Sexcept ->getCode( ) , " \\n ",$except ->getMessage( ) ," ' ) </script> " ; <— O 

} 

echo "FIN"; 
?> 



[JavaScript Application] 



Erreur n* 7 

Division par 0 



y 



Figure 3-5 

Message d'erreur pour le visiteur 



Personnalisation de l'objet Exception 

Le mécanisme de l'héritage (voir le chapitre 9) permet d'étendre une classe pour lui ajou- 
ter des méthodes ou des propriétés. Vous pouvez donc enrichir l'objet Exception avec de 
nouvelles méthodes. Il serait même envisageable de créer des objets personnalisés 
permettant de gérer des types d'erreurs spécifiques. 

L'exemple 3-18 illustre cette possibilité d'extension en créant une classe qui hérite de la 
classe Exception (repère Q)- Une nouvelle méthode, nommée alerte( )(repère 0), est 
ajoutée pour créer une boîte d'alerte JavaScript. Le simple appel de la méthode al erte( ) 
pour l'objet MonException retourne le code qui crée cette boîte (repère Q) sans avoir à 
réécrire systématiquement ce code dans chaque script à chaque utilisation. 

Pour montrer qu'un même bloc try peut gérer plusieurs erreurs différentes, vous créez 
deux conditions if qui correspondent à des situations différentes. La première déclenche 
une exception si $b vaut 0 (repère 0), et la seconde une autre exception si le résultat de 



$a/$b n'est pas un entier, c'est-à-dire si $a n'est pas un multiple entier de $b (repère ©). 
En fonction de la valeur de $b, l'appel de la méthode al erte( ) contenue dans le bloc catch 
(repère Q) de l'objet de type Mon Exception qui sera créé affiche une boîte d'alerte identi- 
que à celle de la figure 3-5 (si $b vaut 0) ou celle de la figure 3-6 (comme c'est le cas dans 
l'exemple où $b vaut 3). 

Exemple 3-18. Exception personnalisée 

<?php 

//Création d'un classe dérivée de Exception 
class MonException extends Exception <—© 
{ 

public function alerte()<— 0 



$thi s->message ="<script type=\"text/javascri pt\''> alerte ' Erreur n' ".$this-> 
^getCodeO." \\n ".$this->getMessage() . " ' )</script> " : 
return $thi s->getMessage( ) ; <— © 

) 

) 

//Utilisation de la classe 

$a=100: 

$b=3; 

try 

{ 

if($b 0) (throw new MonExceptionCDivision par 0 ",7);}<— Q 

elseif($a%$b 0) {throw new MonExceptionC "Quotient entier impossible", 55);} <—© 

else{echo "Résultat de : $a / $b = ",$a/$b:) 

} 

catch(MonException Sexcept) 
{ 

echo $except->alerte( ) ; <— © 

} 

echo "FIN"; 
?> 





Erreur n* 55 

Quotient entier impossible 




Figure 3-6 



Affichage pour une erreur de divisibilité 



Vous pouvez envisager de créer un grand nombre d'objets personnalisés permettant de 
gérer rapidement et d'une manière adaptée toutes sortes d'erreurs de types très différents. 
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Exercices 

Exercice 1 

Rédigez une expression conditionnelle pour tester si un nombre est à la fois un multiple 
de 3 et de 5. 

Exercice 2 

Écrivez une expression conditionnelle utilisant les variables $age et $sexe dans une 
instruction if pour sélectionner une personne de sexe féminin dont l'âge est compris 
entre 21 et 40 ans et afficher un message de bienvenue approprié. 

Exercice 3 

Effectuez une suite de tirages de nombres aléatoires jusqu'à obtenir une suite composée 
d'un nombre pair suivi de deux nombres impairs. 

Exercice 4 

Créez et affichez des numéros d'immatriculation automobile (pour Paris, par exemple) 
en commençant au numéro 100 PHP 75. Effectuez ensuite la même procédure en mettant 
en réserve les numéros dont le premier groupe de chiffres est un multiple de 100. Stockez 
ces numéros particuliers dans un tableau. 

Exercice 5 

Choisissez un nombre de trois chiffres. Effectuez ensuite des tirages aléatoires, et comp- 
tez le nombre de tirages nécessaire pour obtenir le nombre initial. Arrêtez les tirages, et 
affichez le nombre de coups réalisés. Réalisez ce script d'abord avec l'instruction while 
puis avec l'instruction for. 

Exercice 6 

Créez un tableau dont les indices varient de 1 1 à 36 et dont les valeurs sont des lettres de 
A à Z. Lisez ensuite ce tableau avec une boucle for puis une boucle foreach, et affichez 
les indices et les valeurs (la fonction chr( n ) retourne le caractère dont le code ASCII vaut 
n). 

Exercice 7 

Utilisez une boucle whi 1 e pour déterminer le premier entier obtenu par tirage aléatoire qui 
soit un multiple d'un nombre donné. Écrivez la variante utilisant la boucle do...whi 1 e. 

Exercice 8 

Recherchez le PGCD (plus grand commun diviseur) de deux nombres donnés. Gérez au 
moyen d'une exception le cas où au moins un des nombres n'est pas entier. 
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Les chaînes de caractères 



Dans un site Web, vous manipulez constamment des chaînes de caractères, qui constituent 
l'essentiel du contenu de la plupart des pages. Quand le contenu est créé dynamiquement 
à partir de fichiers ou d'une base de données, ce sont encore pour une part importante des 
chaînes de caractères qui sont manipulées. De plus, toutes les variables issues de l'envoi 
d'un formulaire par le poste client sont de type string. 



Affichage des chaînes 

Vous avez vu à l'œuvre à plusieurs reprises la fonction echo pour afficher des données. 
Cette fonction est utilisable de plusieurs façons quand il s'agit d'afficher plusieurs 
chaînes ou variables à la suite l'une de l'autre afin de ne pas multiplier les appels à 
echo. 

Vous pouvez utiliser l'opérateur de concaténation entre chaque expression, comme dans 
l'exemple suivant : 

I$nom = "Schultz" ; 
echo "Bonjour Monsieur ". $noin. " nous sommes le ". date('d'); 

Dans le code, vous réalisez successivement la concaténation d'une chaîne littérale, d'une 
variable de type string, d'une deuxième chaîne puis de la valeur retournée par une fonc- 
tion, qui est ici de type string. Après quoi, echo affiche l'ensemble dans le navigateur. 

Le même résultat pourrait être obtenu sans concaténation, en séparant chaque expression 
par une virgule, comme ci-dessous : 

I echo "Bonjour Monsieur ", $nom," nous sommes le " .date( 'd' ) ; 
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Il n'est pas possible d'inclure de fonction dans une chaîne unique, comme ci-dessous : 

I echo "Bonjour Monsieur $nom nous sommes le date('d')" ; 

Si la variable $nom est bien évaluée, la fonction clate( ) ne pourrait pas l'être. 

La « fonction » pri nt( ) est quasiment similaire à echo. Vous pouvez écrire, par exemple : 

I print ("Bonjour Monsieur $nom nous sommes le ". date('d') ); 

ou : 

I print ("Bonjour Monsieur $nom nous sommes le "). date('d'): 

Dans ces deux cas, vous obtenez la valeur retournée par la fonction date( ). 

Affichage formaté 

Un affichage formaté permet d'obtenir des résultats uniformes, par exemple, pour aligner 
des chaînes sur plusieurs lignes ou des nombres dans un format particulier, comme un 
nombre de décimales fixe et une superposition correcte des chiffres en colonnes pour des 
montants financiers. 

Vous disposez de deux fonctions pour cela, printfO etsprintfO. 
La syntaxe de printf ( ) est la suivante : 

I void printf (string "format", string $chl, string $ch2 $chN) 

Cette fonction affiche directement le contenu des chaînes $chl, $ch2, $chN selon le 
format spécifié dans la chaîne "format". 

La syntaxe de sprintf ( ) est la suivante : 

I string sprintf (string "format" .string $chl, string $ch2 $chN) 

Elle retourne une chaîne unique, qui peut être composée de une ou plusieurs fois les 
chaînes $chl, $ch2, $chN formatées selon le modèle défini dans la chaîne "format", 
comme précédemment. 

Les fonctions vprintf et vsprintf, dont la syntaxe est la suivante : 

Ivoid vprintf (string "format" . array $tab) 
string vsprintf ( string "format", array $tab) 

jouent des rôles équivalant respectivement à printf ( ) et sprintf (), mais avec pour parti- 
cularité que les chaînes sont passées en argument dans un tableau. 

Le plus difficile est ici de bien définir la chaîne de formatage. Celle-ci peut être composée 
d'un texte ordinaire, généralement explicatif, et de directives d'affichage. Ces dernières 
sont constituées de caractères spéciaux qui indiquent la manière dont les variables 
passées en paramètre doivent être incorporées dans la chaîne. C'est cette chaîne qui est 
affichée directement ou retournée, selon la fonction utilisée. 
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Les directives d'affichage sont composées, dans l'ordre, du caractère % suivi de : 

• Un caractère de remplissage, utilisé pour compléter la chaîne quand on lui impose une 
longueur fixe. Pour définir un caractère autre que 0 ou l'espace (valeur par défaut), il 
faut le préfixer par une apostrophe ( ' ). 

• Un caractère moins (-), pour indiquer un alignement à droite. Par défaut, l'alignement 
se fait à gauche. 

• Un nombre, indiquant le nombre de caractères pour la chaîne formatée. 

• Un point suivi d'un entier, indiquant le nombre de décimales à afficher pour les décimaux. 

• Une lettre, indiquant la spécification du type de la valeur à afficher. Le tableau 4-1 donne 
la liste et les définitions de ces caractères. 



Tableau 4-1 - Les caractères de formatage du type de donnée 



Caractère 


Signification 


%b Interprète la ctiaîne $ch comme un entier et l'affiche en binaire : 
$ch=''89"; 

printf ("En binaire $ch s'écrit %b <br />", $ch) ; 
' //Affiche :En binaire 89 s'écrit 1011001 


le Interprète la ctiaîne $cti comme un entier et affiche le caractère dont le code ASCII correspond à 
ce nombre : 
$cti=''115": 

printf C Le caractère de code $ch est %c <br />", $cli); 

//Affiche: Le caractère de code 115 est s 


%d 

1 


Interprète la chaîne $ch comme un entier signé et l'affiche comme un nombre en base 10 : 
$cti = "-25"; 

printf ("La valeur de \$ch est ld\ $cti); //Affiche -25 


%f 


Interprète la chaîne $ch comme un nombre de type double et l'affiche avec sa partie décimale à 6 

chiffres. Les caractères non numériques de $ch ne sont pas pris en compte : 

$ch = "25.52 mètres"; 

printf ("La longueur est de Zf m", $ch); 

// Affiche: La longueur est de 25.520000 m 


%o 


Interprète le chaîne $ch comme un entier et l'affiche en octal : 
$ch = 262; 

printf ("En octal le nombre $ch s'écrit ^o", $ch); 
// Affiche: En octal le nombre 252 s'écrit 374 


Zs 


Interprète $ch comme une chaîne et l'affiche telle quelle : 
$chl = "Monsieur " ; $ch2 = " Schtroumpf" ; 
sprintf ("Bonjour, %s ^s bravo !",$chl $ch2); 
Équivaut à : 

echo "Bonjour $chl $ch2, bravo !"; 


%x 
ou 
%x 


Interprète la chaîne $ch comme un entier et l'affiche en hexadécimal en minuscules (^x) ou (^X) : 
$ch ="252756"; 

printf ("En hexadécimal $ch s'écrit Xx ", $ch) ; 
// Affiche: En hexadécimal 252756 s'écrit 3db54 
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Spécifier le type 

La chaîne doit contenir au minimum ia spécification du type selon lequel la chaîne doit être traitée (entier, 
décimal, octal, hexadécimal, binaire, double ou chaîne). 



L'exemple 4-1 présente une application des fonctions de formatage des chaînes qui affi- 
che les lignes d'une facture et permet d'aligner tous les montants HT, TVA et TTC de 
chaque article sur plusieurs lignes. La première fonction, sprintfO, retourne la chaîne 
des en- têtes affichée avec echo (repère Q)- La chaîne de formatage utilise un caractère de 
remplissage et un spécificateur de longueur. 

Le prix HT de chaque article est contenu dans un tableau (repères et 0). Chaque 
prix est lu par une boucle for contenant la seconde fonction sprintfO, qui permet 
d'aligner correctement les montants, quelle que soit leur longueur (repères 0 et 0). Un 
dernier appel à sprintfO retourne la ligne des totaux de chaque colonne (repère©). 
L'utilisation de la fonction str_repeat( ) permet de créer une chaîne contenant la répéti- 
tion de fois la même chaîne $ch, sans avoir à multiplier les appels à echo (repère 0). 

La syntaxe de str_repeat( ) est la suivante : 

I string str_repeat (string $ch. int N) 

La figure 4-1 illustre le résultat de ce script. 

Exemple 4-1 . Utilisation de spécificateurs 

<?php 

echo"<h3>\/otre facture </h3>"; 

echo sprintf("<b>^'_25s %'_ZSs %'_Z5s <br /></b>","Pr1x H.T. " , "T.V.A. " . 

^"Prix T.T.C."): <-0 

$ht[l] = 27.55 : <-0 

$ht[2] = 3450.40 ; <-0 

$ht[3] = 320.75 : <-0 

for($i=l:$i<4:$i-H-) <-0 

{ 

echo sprintf ("Z'_20.2f ^'_22.2f ^•_20.2f <br />".$ht[$1].$ht[$1]*0.196, 
^$ht[$i]*1.196); <-0 
$total+=$ht[$i] ; 

} 

echo str_repeat("*",71),"<br />";<— 0 

echo sprintf ("%'_20.2f %'_22.2f ^■_20.2f <br />",$total .$total*0.196, 

^$total*1.196): ^0 

?> 

Si le nombre de paramètres de type stri ng est important, il est possible de les placer dans 
un tableau et de passer ce tableau comme deuxième paramètre à l'aide des fonctions 
vprintf ( ) et vsprintf ( ), dont la syntaxe respective est la suivante : 

void vprintf (string "format", array $tab) 
string vsprintf (string "format", array $tab) 

Ces fonctions équivalent respectivement aux fonctions printf ( ) et sprintfO. 
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Figure 4-1 

Formatage de l'affichage 



Ordre de passage 

La fonction sprintf ( ) incorpore les chaînes passées en paramètre dans l'ordre de leur passage. Vous 
pouvez modifier cet ordre ainsi que réutiliser la même valeur sans avoir à passer plusieurs fois le même 
paramètre. 

Le code ci-dessous illustre cette possibilité. La chaîne de formatage du deuxième appel à spri ntf ( ) fait 
référence au premier paramètre en écrivant "%l\$s" et "^2\$s" pour le second : 

$chl = "Monsieur " ; 
$ch2 = " Rasmus" ; 

echo sprintf ("Bonjour %s %s . bravo ! " , $chl ,$ch2) ; 
//Affiche: Bonjour Monsieur Rasmus, bravo ! 
echo sprintf ("Bonjour %Z\$s , bravo %l\$s I " . $chl ,$ch2) ; 
//Affiche: Bonjour Rasmus , bravo Monsieur ! 



Longueur d'une chaîne et codes des caractères 

Pour déterminer le nombre de caractères d'une chaîne, utilisez la fonction strl en ( ), dont 
la syntaxe est la suivante : 

I int strlen (string $ch) 

Le paramètre unique peut aussi bien être une variable de type string ou une chaîne litté- 
rale entre guillemets. 

La fonction strl en ( ) peut servir, par exemple, à vérifier qu'un code postal saisi par un 
internaute comporte bien cinq caractères en écrivant : 

IScode = "7508" ; 
if (strlen($code) != 5) echo "Code erroné !" ; 
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Pour vérifier qu'il s'agit bien de cinq chiffres et non pas de cinq caractères quelconques, 
il faut utiliser une expression régulière (voir la section « Les expressions régulières » 
dans ce chapitre). 

Vous pouvez aussi afficher séparément chaque caractère d'une chaîne à l'aide d'une 
boucle. Une chaîne est en fait assimilable à un tableau (voir le chapitre 5), dont chaque 
lettre est un élément. Vous pouvez donc lire chaque lettre en utilisant la notation à 
crochets des tableaux. 

Le code suivant affiche chaque lettre verticalement en réalisant une boucle for dont la 
condition d'arrêt est déterminée par strl en( ) : 

$lang = "PHP 5" ; 

for ($i =0;$i< strlen ($lang) ;$i-H-) 
{echo "<hl> $lang[$i] </hl>":) 

Vous pouvez retrouver le code Unicode d'un caractère à l'aide de la fonction ord( ) et, 
réciproquement, obtenir le caractère à partir de son code à l'aide de la fonction chr( ). 

La syntaxe de ces fonctions est la suivante : 

Iint ord (string car) 
string chr (int code) 

L'exemple 4-2 crée un mot de passe composé de cinq lettres, dont les codes Unicode 
compris entre 65 et 90 sont générés aléatoirement par la fonction randO (repère©). 
Chaque lettre est créée à partir de son code puis concaténée dans la variable $code 
(repère 0), après quoi le mot de passe est affiché (repère 0). 

Exemple 4-2. Création d'un mot de passe littéral 

<?php 

for($i=l:$i<6:$i-H-) 
{ 

$nb=rand(65.90); <-© 
$code.=chr($nb) ; <— 0 

} 

echo "Votre mot de passe est : ",$code;<— 0 
?> 



Mise en forme des chaînes 

Il est souvent nécessaire de remettre en forme les chaînes utilisées dans les scripts, 
notamment lorsqu'elles émanent d'une source extérieure, comme les saisies faites par 
des visiteurs dans un formulaire. 



Modification de la casse 

PHP offre plusieurs fonctions de conversion de la casse d'une chaîne utilisables pour 
normaliser l'affichage, quelle que soit la casse utilisée par un visiteur pour saisir des 
informations. Il s'agit des fonctions strtolower, strtoupper, ucwords et ucfirst. 



Les chaînes de caractères H 
Chapitre4^^^ 

I string strtolowerCstring $ch) 

retourne la chaîne avec tous les caractères en minuscules. 
I string strtoupperCstring $ch) 

retourne la chaîne avec tous les caractères en majuscules. 
I string ucwords(string $ch) 

retourne la chaîne avec toutes les initiales des mots qui la composent en majuscules. 
I string ucfirst(string $ch) 

retourne la chaîne avec uniquement la première lettre en majuscule. 

Pour réaliser un affichage conforme aux usages, vous pouvez combiner plusieurs de ces 
fonctions pour éliminer les fantaisies éventuelles des différents utilisateurs, par exemple 
pour réaliser un affichage sur une page ou enregistrer ces données dans une base de données. 
Par exemple, si la saisie fantaisiste est "jEaN EngelS", utilisez d'abord strtolower( ) pour 
transformer le texte en minuscules puis ucwords( )pour mettre les initiales en majuscules. 

L'exemple 4-3 utilise les fonctions précédentes pour réaliser un affichage normalisé à 
partir de chaînes ayant des casses hétéroclites. 

Exemple 4-3. Normalisation de la casse des chaînes 

<?php 

Snom = "ENgelS" ; 

Sprenom = "jEan " ; 

$adresse = "21, rue compoinT" ; 

$ville = "75018 pArIs" ; 

Smail = "ENGELS@funPHP.Com" ; 

Sprenom = ucfirst (strtolower (Sprenom )) ; 

Snom = strtoupper (Snom) ; 

Sadresse = ucwordsCstrtolower (Sadresse )) ; 

$ville = strtoupper (Svllle); 

Smail = strtolower ($ma11): 

echo "Mes coordonnées <br />"; 

echo Sprenom, $nom, "<br />"; 

echo Sadresse, "<br />" ; 

echo Sville, "<br />" ; 

?> 

Le script fournit l'affichage standard suivant : 



Mes coordonnées 
Jean ENGELS 
21, rue Compoint 
75018 PARIS 



Les utilisateurs peuvent donc saisir leurs coordonnées dans un formulaire dans la casse 
de leur choix. Les résultats, quant à eux, auront tous la même présentation. 
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Gestion des espaces 

De même, dans le but de réaliser un affichage uniforme à partir de saisies des utilisateurs 
ou de stocker ces dernières dans une base de données, il peut être utile de supprimer les 
caractères d'espaces inutiles en début et en fin de chaîne. 

Vous disposez pour cela des trois fonctions, 1 trim, rtrim et trim. 

I string Itrim (string $ch [.string liste]) 

renvoie la chaîne $ch nettoyée des espaces situés en début de chaîne. 

I string rtrim (string $ch [.string liste]) 

supprime les espaces situés en fin de chaîne. 

I string trim (string $ch [.string liste]) 

supprime les espaces situés en début et en fin de chaîne. 

Le paramètre liste permet de définir une liste de caractères à supprimer, qu'ils soient des 
caractères d'espacement ou des caractères quelconques. 

Le code suivant supprime les points situés au début et l'espace situé à la fin de la chaîne 
$a ainsi que les caractères de soulignement situés à la fin de la chaîne $b : 

<?php 

$a = " . . .Jean " ; 

$b = "Dupont ": 

echo $a.$b."<br />"; 

echo trim($a,' .')," ".rtrim($b,' _'); 

?> 

Les résultats affichés sont : 



. . .Jean Dupont 
Jean Dupont 



Dans le même ordre d'idée, la fonction wordwrap( ) permet d'afficher un texte long avec 
une largeur maximale déterminée. Sa syntaxe est la suivante : 

I string wordwrap ( string $ch [. int H [, string car [. boolean coupe]]]) 

Le paramètre N définit cette largeur et car contient la chaîne à insérer dans $ch tous les 
caractères. Le paramètre booléen coupe, permet, s'il vaut TRUE, d'effectuer une césure des 
mots dont la longueur dépasse caractères. 

Avec le code suivant : 

^ echo worclwrap($ch.30."<br />".!): 

le contenu de la chaîne $ch s'affiche dans une colonne de 30 caractères de largeur. Dans 
le code source XHTML, vous trouvez donc un élément <br /> tous les 30 caractères. 
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Entités XHTML et caractères spéciaux 

Pour ajouter automatiquement le caractère d'échappement \ devant les caractères 
spéciaux tels que apostrophe ('), guillemets ("), antislash (\) et le caractère NUL, vous 
devez utiliser la fonction addsl ashes( ), dont la syntaxe est la suivante : 

I string addsl ashes (string $ch) 

Cette fonction peut être utilisée avant d'enregistrer des chaînes dans une base de données. 
Réciproquement, la fonction stri psi ashes ( ) enlève les caractères d'échappement. 

Par exemple, le code suivant : 

$ch="Le répertoire est : 'C:\PHP_doc\php5'"; 
$ch = addsl ashes($ch) ; 
echo $ch; 

$ch =stripslashes($ch) ; 
echo $ch; 

affiche la chaîne $ch après chacune de ces transformations : 



Le répertoire est : \'C:\\PHP_doc\\php5\' 
Le répertoire est : 'C:\PHP_doc\php5' 



Données de formulaire 

La fonction addsl ashesO est inutile pour les données en provenance d'un formulaire si la directive 
magi c_quotes_runtime est active dans le php. i ni . 



La fonction quotemeta( ) est similaire à addslashes( ), à la différence près qu'elle introduit 
un caractère d'échappement devant les métacaractères ., \, +, *, ?, [, ], (, ), $ et Sa 
syntaxe est la suivante : 

I string quotemeta ( string $ch) 

Pour créer du code XHTML ou XML, vous devez transformer certains caractères 
spéciaux (&, ", ', <, >) en entités de caractères. Vous utilisez pour cela la fonction 
html specialchars( ), dont la syntaxe est la suivante : 

I string htmlspecialchars (string $ch [, int CTE[, string charset]]) 

Le paramètre CTE est une constante qui détermine le traitement des guillemets. Elle prend 
les valeurs suivantes : 

• ENT_COMPAT OU 2 (valeur par défaut) convertit les guillemets doubles mais pas les guille- 
mets simples. 

• ENT_QUOTES OU 3 convertit les guillemets doubles et simples. 

• ENOOQUOTES OU 0 ne traite aucun des guillemets. 

Le paramètre charset désigne le jeu de caractères utilisé. Par défaut, il s'agit de ISO- 
8859-1. 
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La fonction html enti ti es ( ) , dont la syntaxe est la suivante : 

I string htmlentities (string $ch [, int CTE[,string charset]]) 

retourne une chaîne dans laquelle tous les caractères spéciaux en XHTML, donc tous 
ceux dont le code UNICODE est supérieur à 128, en entités de caractère interprétables 
par les navigateurs. 

Les paramètres CTE et charset ont les mêmes significations que dans la fonction 
htmlspecialcharsO. Appliquée aux saisies des visiteurs, cette fonction empêche la créa- 
tion intempestive de code XHTML en cas de saisie de balises dans une zone de texte. 

Dans le code suivant : 

$ch = "Cliquez sur l'icône en tête pour démarrer" ; 

$ch2 = "L'élément XHTML du bouton est <button>" ; 

echo htmlentities($ch); 

echo "<br />"; 

echo htmlentities($ch2) ; 

Si vous écrivez "echo $ch2 ; " vous obtenez un bouton dans la page alors qu'en appelant 
html enti t1 es ( ) le code apparaît normalement. Le code source du fichier XHTML 
contient les lignes suivantes : 



Cliquez sur 1 'ic&ocirc:ne en tête pour démarrer<br /> 
L'élément XHTML du bouton est &lt:button&gt: 



Pour réaliser l'opération inverse, c'est-à-dire transformer les entités en caractères ordi- 
naires, vous devez faire appel à la fonction suivante : 

I string html_entity_decode (string $ch [, int CTE[, string charset]]) 

qui possède les mêmes paramètres. 

Pour transformer les sauts de lignes "\n" d'une chaîne en sauts de ligne XHTML <br />, 
utilisez la fonction ni 2br( ). Elle permet d'améliorer la présentation des textes saisis dans 
les zones multilignes (voir le chapitre 6). 

Le code suivant affiche la chaîne $ch sur trois lignes : 

|$ch = "Voici une ligne \n puis une autre \n Fin\n" ; 
echo nl2br($ch) ; 

Nous avons déjà signalé que, dans un site dynamique, de nombreuses chaînes prove- 
naient de saisies opérées par les visiteurs et enregistrées ensuite pour être affichées sous 
une forme quelconque dans une page XHTML. 

Imaginez qu'une personne mal intentionnée saisisse la chaîne $ch suivante dans un 
formulaire afin qu'elle soit enregistrée et réutilisée par la suite : 

I $ch="<script type= text/javascript> al ert( ' Sal ut ' ) : history .back( ) : </script>": 

Si le site doit utiliser cette chaîne pour l'afficher avec une instruction echo, la page ainsi 
créée est inutilisable car le navigateur affiche d'abord une boîte d'alerte JavaScript, créée 
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par la fonction alerte ). L'utilisateur est ensuite redirigé automatiquement vers la page 
précédente par la fonction history .back( ). La page n'est donc jamais visible. 

Pour éviter ces problèmes, il est possible d'enlever les balises XHTML d'une chaîne 
grâce à la fonction stri ps_tags( ), dont la syntaxe est la suivante : 

I string strip_tags ( string $ch [, string balise_ok]) 

La fonction retourne la chaîne $ch débarrassée des balises d'ouverture et de fermeture des 
éléments XHTML autres que ceux qui sont précisés dans le deuxième paramètre comme 
étant acceptés. 

Par exemple, dans le code suivant : 

$ch="<script type =text/javascript> alert( 'Salut' ); hi story .back( ) ; </script>"; 
//echo $ch; <— O 
$ch=strip_tags($ch) ; <— 0 
echo $ch; ^0 

si vous décommentez la deuxième ligne (repère Q)' vous vous exposez au problème 
signalé ci-dessus, alors qu'en appliquant la fonction strip_tags( ) à $ch (repère 0) puis 
en affichant la chaîne $ch modifiée (repère ©), la page ne contient que l'affichage : 



alerte 'Sal ut ') ; hi story .back( ) ; 



Tout en étant parasite, cet affichage n'est pas dangereux. 



Recherche de sous-chaînes 

Une chaîne pouvant être considérée comme un tableau de caractères (indice de 0 à AO, 
vous pouvez récupérer le caractère d'indice en écrivant $ch[N] ou $ch[$N] si la variable 
$N contient un entier. 

Le code suivant : 

|$ch = "Bonjour Geneviève" ; 
echo "Le 9ème caractère de la chaîne $ch est {$ch[8]}" ; 

affiche le caractère G. 

Plusieurs fonctions spécifiques permettent d'extraire une sous-chaîne d'une chaîne 
donnée. La fonction strstr( ) — ou strchrC ), qui en est un alias — , dont la syntaxe est la 
suivante : 

I string strstr (string $ch, string $ch2) 

recherche si la chaîne $ch2 est contenue dans $ch et retourne tous les caractères allant de 
la première occurrence de $ch2 jusqu'à la fin de $ch. Cette recherche est sensible à la 
casse. Pour effectuer une recherche insensible à la casse, vous devez utiliser la fonction 
suivante : 



I string stristr (string $ch, string $ch2) 
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Par exemple, le code suivant : 

$ch = "Perette et le pot au lait" 
$ssch = strstr ($ch, "pot") 
echo $ssch ; 

affiche la sous-chaîne "pot au lait". 

Si $ch2 ne figure pas dans $ch, la fonction retourne FALSE. 

Contrairement à la précédente, la fonction strrchr( ), dont la syntaxe est la suivante : 

I string strrchr (string $ch, string $ch2) 

ne retourne que la portion de $ch présente à partir de la dernière occurrence de $ch2. Par 
exemple : 

$ch = "Perette et le pot au lait. C'est pas de pot !" ; 
$ssch = strrchr($ch, "pot") 
echo $ssch ; 

n'affiche que la sous-chaîne "pot ! ". 

Les fonctions suivantes permettent d'extraire des sous-chaînes en fonction des indices 
des caractères dans la chaîne analysée (le premier étant à l'indice 0). 

La fonction substr( ), dont la syntaxe est la suivante : 

^ string substr (string $ch, integer ind [, integer N]) 

retourne la chaîne contenant A'^ caractères de $ch extraits à partir de l'indice ind inclus. Si 
le paramètre est omis, elle retourne la sous-chaîne comprise entre l'indice ind et la fin 
de $ch. 

La fonction substr„count( ) retourne le nombre d'occurrences d'une sous-chaîne $ssch 
dans une chaîne $ch. Sa syntaxe est la suivante : 

^ int substr_count (string $ch, string $ssch) 

II est possible de remplacer toutes les occurrences d'une sous-chaîne par une autre au 
moyen de la fonction str_repl ace( ) : 

I string str_replace(string $chl, string $ch2, string $ch [.string $var]) 

La fonction retourne la chaîne $ch, dans laquelle toutes les occurrences de $chl sont 
remplacées par $ch2. Le quatrième paramètre est le nom d'une variable à laquelle est 
passé par référence le nombre de remplacement effectué. Dans l'exemple 4-6, le mot 
"pot" est remplacé par "bol ". 

Exemple 4-5. Extraction et remplacement de sous-chaînes 

<?php 

$ch = "Perette et le pot au lait. C'est pas de pot!" ; 
$ssch = substr ($ch, 8, 9) ; 
eclio $ssch,"<br />" ; 
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Sssch = substr($ch.8) ; 
echo $ssch ,"<br />"; 
$ch2="pot": 

$nb=SLibstr_count($ch,$ch2) : 

echo "Le mot $ch2 est présent $nb fois dans $ch <br />"; 
$ch3=str_repl ace( 'pot' , 'bol ' ,$ch) ; 
echo $ch3,''<br />" ; 
?> 

Les résultats affichés sont les suivants : 



et le pot 

et le pot au lait. C'est pas de pot! 

Le mot pot est présent 2 fois dans Perette et le pot au lait. C'est pas de pot! 
Perette et le bol au lait. C'est pas de bol! 
2 remplacements 



La fonction strpos( ) retourne la position du premier caractère de la première occurrence 
d'une sous-chaîne $ch2 dans $ch ou FALSE si $ch2 ne figure pas dans $ch. 

La syntaxe de la fonction strpos( )est la suivante : 

I int strpos (string $ch,string $ch2[,int N]) 

Puisque la fonction retourne FALSE si le mot n'est pas trouvé, elle peut permettre indirec- 
tement de détecter la présence d'un mot dans une chaîne en la plaçant dans une condition 
if, ce qui est réalisé dans l'exemple 4-6 (repère O)- 

Les variantes de cette fonction, aux syntaxes identiques, sont stri pos ( ) , qui est insensible 
à la casse, strrposO, qui retourne la position de la dernière occurrence trouvée, et 
strriposO, qui est identique à strrposO mais insensible à la casse. 

'■^ Exemple 4-6. Recherche de la position ou de l'existence d'un mot 

<?php 

$ch = "Perette et le pot au lait. C'est pas de pot ! La Fontaine" ; 
echo "\$ch = $ch <br />"; 
$ch2 = "pot" : 

//recherche sensible à la casse 
$n=strpos ($ch, $ch2): 

echo "Le mot $ch2 commence à la position $n dans \$ch <br />" ; 
//recherche insensible à la casse 
$ch3 = "POT" : 
$n2=stripos($ch, $ch3): 

echo "Le mot $ch3 commence à la position $n2 dans \$ch <br />" ; 
//recherche de la dernière occurrence sensible à la casse 
$n3=strrpos($ch, $ch2); 

echo "La dernière occurrence du mot $ch2 commence à la position $n3 dans \$ch<br />" 

//recherche sensible à la casse de l'existence d'un mot 
$ch4="fontaine" ; 
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ifdstrpos ($ch,$ch4)) 
{ echo "Le mot $ch4 n'est pas dans \$ch":) 
?> 

Le résultat affiché est le suivant : 



$ch = Perette et le pot au lait. C'est pas de pot ! La Fontaine 
Le mot pot commence à la position 14 dans $ch 
Le mot POT commence à la position 14 dans $ch 

La dernière occurrence du mot pot commence à la position 40 dans $ch 
Le mot fontaine n'est pas dans $ch 

Les mêmes conventions de formatage utilisées par la fonction printfO sont utilisables 
pour extraire des sous-chaînes et affecter leurs valeurs à des variables. Vous pouvez utili- 
ser ces variables indépendamment de la chaîne dont elles sont extraites à l'aide de la 
fonction sscanf ( ), dont la syntaxe est la suivante : 

I array|string sscanf (string $ch, string "format" [, $varl,$var2,...]) 

Pour utiliser cette fonction, la chaîne $ch doit répondre au format défini à l'aide des 
spécificateurs récapitulés au tableau 4-1, que vous avons déjà rencontrés avec la fonction 
pri ntf ( ). Elle peut alors être bien analysée. Chacun de ces éléments est affecté aux varia- 
bles dont les noms sont donnés dans les paramètres $varl, $var2, etc. 

Dans l'exemple 4-6, la chaîne $personne contient quatre informations écrites selon le 
format précis suivant : 

I "date_de_naissance-date_de_décès prénom nom" 

Dans l'exemple 4.7, la chaîne de format qui permet d'analyser et de récupérer chacun de 
ses éléments est la suivante (voir repère O) : 

I $format="%d-%d %s %s" 

La fonction sscanf ( ) affecte ces informations aux variables nommées $ne, $mort, Sprenom 
et $nom (repère 0) et retourne le nombre d'informations dans la variable $nb. Ces varia- 
bles sont utilisées pour un affichage (repère 0). 

Exemple 4-7. Capture de sous-chaînes dans des variables 

<?php 

$personne = "1685-1750 Jean-Sébastien Bach"; 
$format="%d-^d %s ^s":<-0 

$nb = sscanf($personne,$format,$ne,$mort,$prenom.$nom); ^0 
echo "$prenom $nom né en $ne, mort en $mort <br />";<— 0 
echo "Nous lisons $nb informations";; 
?> 

Le résultat affiché est le suivant : 



Jean-Sébastien Bach né en 1685, mort en 1750 
Nous lisons 4 informations 



Les chaînes de caractères 

Chapitre 4 



Comparaison de chaînes 

Les opérateurs de comparaison usuels sont utilisables avec les chaînes. Cela inclut bien 
sûr les opérateurs d'égalité (==) et d'identité (===), ce dernier ne permettant d'obtenir la 
valeur TRUE dans une expression conditionnelle que si les deux opérandes ont non seule- 
ment la même valeur mais aussi le même type. 

Avec l'opérateur d'égalité, si les deux opérandes sont des chaînes, elles doivent avoir exac- 
tement les mêmes caractères pour que l'égalité soit vérifiée. Le code suivant affiche FALSE : 

|$ch="scripts PHP 5"; 
$ch2="script PHP 5"; 
if($ch2==$ch) echo "TRUE <br />": 
else echo "FALSE <br />": 

Si la comparaison se fait entre une chaîne commençant par des chiffres et un nombre, elle 
a lieu comme s'il s'agissait de deux nombres, seuls les caractères numériques du début 
de la chaîne étant pris en compte. Le code suivant affiche TRUE : 

$nb=59: 

$ch="59scripts" ; 

if($ch==$nb) echo "TRUE <br />"; 
else echo "FALSE <br />": 

Par contre, si vous écrivez if($ch===$nb), le script affiche FALSE car les types sont diffé- 
rents (integer et string). 

De même, si vous utilisez les opérateurs arithmétiques +, -, *, /, , et % entre une chaîne et 
un nombre, vous obtenez un nombre si la chaîne commence par des chiffres. Le code 
suivant affiche, par exemple, le nombre 531. Il ne s'agit pas de la chaîne "531" mais d'un 
entier, ce qui est vérifiable en utilisant la fonction gettype( ) : 

|$nb=59: 
$ch="9scripts" ; 
echo $nb*$ch://Affiche 531 soit 59 x 9 
echo gettype($nb*$ch) ://Affiche integer 

Moins habituel, vous pouvez comparer des chaînes alphabétiques entre elles ou avec des 
nombres au moyen des opérateurs a priori réservés à des nombres. Il s'agit des opéra- 
teurs <, >, <= et >=. Si les opérandes sont des chaînes, la comparaison est effectuée en 
fonction de l'ordre ASCII des caractères des chaînes. Par exemple, le code suivant : 

$chl="Bl anc" ; 
$ch2="Bleu": 
$ch3="bl anc" ; 

if($chl>$ch2) echo "TRUE <br />"; 

else echo "FALSE <br />"; //Affiche FALSE 

if($chl<$ch3) echo "TRUE <br />"; 

else echo "FALSE <br />"; //Affiche TRUE 

affiche d'abord FALSE pour la comparaison ($chl>$ch2) car les deux premiers caractères 
sont identiques et que "a<e" est vrai dans l'ordre ASCII. Il affiche ensuite TRUE pour la 
comparaison ($chl<$ch3) car les minuscules ont des codes inférieurs aux majuscules. 
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Pour comparer des chaînes et obtenir leur ordre alphabétique, au sens ASCII du terme, 
vous disposez aussi des fonctions PHP suivantes : 

Iint strcmp (string $chl, string $ch2) 
int strcasecmp (string $chl, string $ch2) 

Leur fonctionnement est identique, mais la première fonction est sensible à la casse alors 
que la seconde ne l'est pas. Elles retournent toutes deux un nombre négatif (générale- 
ment -1) si $chl est inférieure à $ch2, un nombre positif (généralement 1) dans le cas 
contraire et 0 en cas d'égalité. 

Les fonctions strncmp( ) et strncasecmp( ) réalisent respectivement les mêmes actions que 
strcmpO et strcasecmpO mais en limitant la comparaison aux premiers caractères. 
Leurs syntaxes sont les suivantes : 



int strncinp(string $chl, string $ch2, int N) 

int strncasecmp ( string $chl. string $ch2, int N) 



I 

Le code suivant assure la même comparaison que les opérateurs vus précédemment : 



$chl="Bl anc" ; 
$ch2="Bleu"; 
$ch3="bl anc" ; 

echo strcmp ($chl ,$ch2) ;//Affiche -1 
echo strcasecmp ($chl ,$ch3) ;//Affiche 0 
echo strncasecmp ( $chl, $ch2 .2) ://Aff i che 0 

La méthode de comparaison de ces fonctions étant fondée sur les codes des caractères, 
elle donne des résultats qui peuvent paraître étranges. Par exemple, le code suivant : 

I$ch4="page2" ; 
$ch5="pagel2": 
echo strcmp ( $ch4,$ch5) ://Affiche 1 

affiche la valeur 1. "page2" est donc considéré supérieur à "pagel2". Si vous souhaitez 
réaliser un tri, cela n'est pas concevable. 

Pour pallier cet inconvénient, vous disposez des fonctions suivantes, qui effectuent une 
comparaison dans l'ordre « naturel », dans lequel "page2" est avant "pagel2" : 

Iint strnatcmp (string $chl, string $ch2) 
int strnatcasecmp (string $chl, string $ch2) 

La première fonction est sensible à la casse mais pas la seconde. 

Le code suivant : 

I$ch4="page2" : 
$ch5="pagel2": 
echo strnatcmp($ch4,$ch5)://Affiche -1 

affiche une valeur négative, et vous avez donc bien "page2" inférieur à "pagel2". 
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Dans des recherches de mots, il est possible d'obtenir le nombre de caractères communs 
à deux chaînes en utilisant la fonction suivante : 



qui retourne ce nombre. Si le troisième paramètre est utilisé, le pourcentage de similarité 
est retourné dans la variable $pourcent (le nom de la variable est ici arbitraire). Notez que 
la comparaison est sensible à la casse. 

Par exemple, le code suivant : 

$ch4="MySQL"; 
$ch5="PgSQL": 

echo similar_text($ch4,$ch5,$pourc), " caractères communs"; 
echo "Similarité : " .Spourc, "%" ; 

affiche le résultat suivant : 



3 caractères communs 
Similarité : 60% 



Vous avez la possibilité d'extraire chacun des « mots » d'une chaîne et d'obtenir un 
tableau dont les éléments contiennent chacun de ces mots. Vous devez pour cela utiliser 
la fonction suivante : 



La fonction retourne un tableau des mots de $ch, le critère de séparation étant donné par 
la chaîne sep (souvent une espace). Si le dernier paramètre est fourni, le tableau ne 
contient que éléments au maximum, le dernier élément contenant toute la fin de la 
chaîne initiale. 

La fonction impl ode( ) est la réciproque de expl ode( ). Elle retourne une chaîne composée 
des éléments d'un tableau séparés par un caractère donné. Sa syntaxe est la suivante : 

I string implode ( string sep, array $tab) 

L'exemple 4-8 illustre ces deux fonctions avec différents séparateurs. 
Exemple 4-8. Passages réciproques de chaînes en tableaux 

<?php 

//Passage chaîne -> tableau 
$chl="L'avenir est à PHP5 et MySQL"; 
$tabl=explode(" ",$chl); 
echo $chl , "<br />" ; 
print_r($tabl) ; 
echo "<hr />"; 



■ 



int similar_text ( string $chl, string $ch2 [, Spourcent]) 



Transformation de chaînes en tableaux 



I array explode ( string sep, string $ch [, int N]) 
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$ch2="C: \wampserver\www\php5\chaines\string2.php" ; 

$tab2=explode("\\",$ch2): 

echo $ch2,"<br />"; 

print_r($tab2); 

echo "<hr />"; 

//Passage tableau -> chaîne 

$tab3[0]="Bonjour" ; 

$tab3[l] = "nionsieur" ; 

$tab3[2] = "Rasnius" ; 

$tab3[3]="Merci!": 

$ch3=iniplode(" ".$tab3): 

echo $ch3,"<br />"; 

?> 

L'exemple retourne les résultats suivants : 



L'avenir est à PHP5 et MySQL 

Array ( [0] => L'avenir [1] => est [2] => à [3] => PHP5 [4] => et [5] => MySQL ) 
C: \wanipserver\www\php5\chaines\string2.php 

Array ( [0] => C: [1] wampserver [2] => www [3] => php5 [4] => chaînes [5] => 
string2.php ) 

Bonjour monsieur Rasmus Merci! 



Les expressions régulières 

Une expression régulière, ou regular expression, ou encore expression rationnelle, 
permet de définir un modèle général, appelé motif de l'expression régulière, au moyen de 
caractères particuliers, représentatifs d'un ensemble de chaînes de caractères très variées. 

Si vous définissez, par exemple, comme caractéristique d'un modèle de mot que la 
première et la troisième lettre d'un mot doivent être un "p", quantité de mots d'un diction- 
naire français répondent à ce critère, tels papa, pipe, pipeau, pipelette, etc. Ces motifs 
permettent de rechercher dans un texte s'il existe des occurrences d'un mot ou de retrou- 
ver tous les mots qui répondent à tel critère particulier, comme vous venez de le voir. 

Ils peuvent aussi permettre de vérifier si une saisie faite par un visiteur du site est 
conforme au format couramment attendu, comme celui d'une adresse e-mail, et, dans le 
cas contraire, d'afficher un message d'erreur. Sans ce type de vérification, tout contact 
serait impossible entre un client qui se serait identifié avec une adresse contenant une 
erreur de format et un site commercial qui enregistre les adresses e-mail pour envoyer 
une confirmation de commande, par exemple. 

Vous allez voir successivement comment écrire des motifs représentatifs puis les diffé- 
rentes fonctions offertes par PHP pour opérer des vérifications sur des chaînes de 
caractères. Dans la pratique, ces chaînes proviennent le plus souvent de saisies effectuées 
dans un formulaire. 
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Définition d'un motif élémentaire 

L'écriture des motifs d'expressions régulières est la partie la plus rébarbative du travail 
de codage. Un grand soin est requis dans leurs écritures car cela conditionne la qualité du 
résultat. Les motifs sont toujours contenus dans des chaînes de caractères, et donc entre 
guillemets. 

Recherche de un ou plusieurs caractères 

Pour rechercher la présence d'un caractère particulier, il suffit de l'inclure entre des 
guillemets simples ou doubles. Pour rechercher le caractère @, vous écrivez le modèle : 

I $model e="@" : 

Pour vérifier si une chaîne contient un au moins des caractères d'une liste, vous énumérez 
tous ces caractères entre crochets. 

Pour rechercher un ou plusieurs des caractères xyz, vous avez donc le motif suivant : 
I $moclele="[xyz]"; 

Caractère et caractères 

La présence d'un seul des caractères de la liste dans la chaîne sur laquelle s'effectue la recfierche fournit 
un résultat positif. La présence d'autres caractères quelconques est donc possible. En d'autres termes, la 
présence d'au moins un des caractères définis dans le motif ne signifie pas qu'il n'y en a pas d'autres non 
contenus dans le motif. 

Avec la même syntaxe, vous pouvez définir comme motif un intervalle de lettres ou de 
chiffres. 

Par exemple, si vous écrivez : 
I $modele = "[a-z]"; 

vous recherchez un mot d'au moins un caractère contenant n'importe quelles lettres 
minuscules. 

De même, le motif suivant : 
I Smodele = "[A-Z]"; 

recherche n'importe quel groupe de majuscules. 

Le suivant : 

I $modele = "[0-9]"; 

recherche la présence d'au moins un chiffre entre 0 et 9. 
Échappement des caractères spéciaux 

Pour recfiercher dans une chaîne les caractères qui ont une signification particulière, vous devez les 
échapper en les faisant précéder d'un antislash (\). Cela s'applique aux caractères .,$,", ?, \, [, ], 
(, ), + et*. 
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Il existe des classes de caractères prédéfinies, qui évitent d'avoir à créer vous-même les 
ensembles de caractères recherchés. Ces classes sont récapitulées au tableau 4.2. 







Tableau 4-2 — Les classes de caractères prédéfinies 


Classe 


Définition de ia recherche 


[[ 


al num: ]] 


Tous les caractères alphanumériques. Équivalent de l'ensembie [a-zA-ZO-9] 


[[ 


alpha:]] 


Tous les caractères alphabétiques. Équivalent de l'ensemble [a-zA-Z] 


[[ 


blank:]] 


Tous les caractères blancs (espaces, tabulations, etc.) 


[[ 


Ctrl :] ] 


Tous les caractères de contrôle 


[[ 


digit:]] 


Tous les chiffres. Équivalent de l'ensemble [0-9] 


[[ 


print:]] 


Tous les caractères imprimables, non compris les caractères de contrôle 


[[ 


punct:]] 


Tous les caractères de ponctuation 


[[ 


space:]] 


Tous les caractères d'espace (espace, fabulation, saut de ligne) 


[[ 


upper:]] 


Tous les caractères en majuscules 


[[ 


xdigit:]] 


Tous les caractères en hexadécimal 



Les classes du tableau sont utilisables comme les autres motifs en les écrivant dans une 
chaîne de caractères délimitée par des guillemets. 

Vous écrivez, par exemple, le modèle suivant : 

I $modele="[[ :al pha: ]]" ; 

pour rechercher des caractères alphabétiques en minuscule ou en majuscule. 

Le modèle suivant : 

I $modele="[[:digit:]]" ; 

vous permet de rechercher la présence de chiffres. 
Recherche d'une chaîne précise 

Pour rechercher la présence d'un mot précis dans une chaîne, créez le motif en écrivant le 
mot entre guillemets. La recherche est validée si le mot se trouve exactement dans la 
chaîne analysée et en respectant la casse. 

Le motif suivant : 

I SiTiodele = "Paris"; 

vérifie si le mot Paris est présent dans la chaîne analysée. La chaîne Visite à Paris est 
donc conforme au modèle mais pas la chaîne Visite à paris. 

Pour détecter la présence d'au moins une chaîne parmi deux, vous devez utiliser l'opéra- 
teur logique OU, symbolisé par le caractère pipe ( | ) placé entre les mots à rechercher. 
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Le motif suivant : 

I $moclele="\.coin|\.net": 

recherche des chaînes .com ou .net. L'adresse www.php.net est donc validée mais pas 
www.w3c.org. 

Restriction de caractères 

Pour interdire la présence d'un groupe de caractères, faites-le précéder par le caractère 
Pour exclure une plage entière de caractères, incluez le caractère " devant les caractères 
entre crochets qui définissent l'ensemble des caractères ou la plage de caractères. 

Prenez garde à cette définition car la présence d'un seul caractère différent de ceux qui 
sont exclus rend la vérification valide, même si ce caractère est précédé ou suivi de carac- 
tères interdits. 

Par exemple, le motif suivant : 
I $modele="["abc]"; 

exclut les caractères abc. La chaîne caba ne répond donc pas à cette définition alors que la 
chaîne cabas est conforme au modèle par le seul ajout du caractère s. 

De même, le motif suivant : 

I $modele="[''A-Z]": 

exclut les chaînes composées uniquement de lettres majuscules. Par exemple, la chaîne 
PHP est exclue mais pas PHP 5. 

Le motif : 

I $moclele="[''0-9]": 

exclut les chaînes composées uniquement de chiffres. Par exemple, la chaîne 2005, qui ne 
comporte que des chiffres, est exclue mais pas la chaîne 02-03-2005, qui comporte un 
autre caractère. 

Ce même caractère " peut avoir une autre signification s'il est placé devant un caractère 
ou une classe de caractères mais pas entre crochets. Dans ce cas, la chaîne sur laquelle est 
effectuée la recherche doit commencer par les caractères qui suivent. 

Par exemple, le motif suivant : 

I $modele= ""bon"; 

permet de rechercher si une chaîne commence par les lettres bon, comme bonjour Max ou 
bonne blague. 

Pour imposer qu'une chaîne se termine pas un ou plusieurs caractères déterminés, faites 
suivre ces derniers du caractère $. 

Pour imposer, par exemple, qu'une adresse e-mail se termine par .com, écrivez le motif 
suivant : 

I $modele= "\.com$": 
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Création de modèles généraux 

L'utilisation de caractères spéciaux permet de créer des modèles, dans lesquels vous 
pouvez préciser si un caractère doit être présent zéro, une ou plusieurs fois de suite. 

Le caractère point ( . ) permet de rechercher n'importe quel caractère. L'exemple suivant : 

I $modele= "mat." 

crée le modèle permettant de rechercher tous les mots contenant le mot mat suivi d'au 
moins un caractère. Vous obtenez aussi bien mate, math que matériel mais pas la chaîne 
échec et mat, car mat n'est suivi d'aucun caractère. 

Le caractère ? indique que le caractère qui précède doit être présent zéro ou une fois. 
Le caractère recherché peut être présent plusieurs fois sans pour autant invalider la 
recherche. 

L'exemple suivant : 

I $modele= "math?" 

crée le modèle permettant de chercher la présence des lettres mat suivies ou non de la 
lettre h dans une chaîne quelconque. Vous pouvez obtenir math, mathématiques, matrice, 
mais aussi mathh, car il peut exister d'autres caractères identiques après le motif défini. 

Le caractère + indique que le caractère qui précède doit être présent au moins une fois 
dans la chaîne analysée. 

L'exemple suivant : 

I $modele= "nat+" 

recherche si une chaîne contient les lettres na suivies de une ou de plusieurs lettres t. 
Vous obtenez, par exemple, nat, nathalie, natte, naturel, mais pas naval. 

Le caractère * indique que le caractère qui précède doit être présent zéro ou plusieurs fois 
dans la chaîne sur laquelle s'effectue la recherche. 

Le motif suivant : 
I $modele= "pour*" ; 

recherche les lettres pou suivies de la lettre r présente un nombre quelconque de fois puis, 
éventuellement, d'une suite de caractères quelconque. Vous pouvez obtenir les mots pou, 
poulette, pourri, etc. 

En associant les caractères . et *, vous pouvez rechercher une suite quelconque de carac- 
tères, le point spécifiant n'importe quel caractère et l'étoile zéro à occurrences d'un 
même caractère. 

Le motif suivant : 

I $modele= "mat.*" ; 

recherche tous les mots d'un nombre de caractères quelconque contenant les lettres mat. 
Vous trouvez, par exemple, mat, math, matériel ou matter. 



Les chaînes de caractères H 
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L'usage des parenthèses associées aux caractères précédents effectue des regroupements 
permettant des recherches plus précises. 

Le motif suivant : 
I $modele= "(nia)+" ; 

recherche la présence du groupe de caractères ma au moins une fois. 
Recherche d'un nombre donné de caractères 

L'usage des accolades permet de préciser le nombre de fois que vous souhaitez voir 
apparaître un caractère ou un groupe de caractères, selon les définitions suivantes : 

• {n} cherche exactement n fois le caractère ou le groupe qui précède. 

• {n , } cherche au minimum n fois le caractère ou le groupe qui précède. 

• {n ,m} cherche entre n et m fois le caractère ou le groupe qui précède. 
Par exemple, le motif suivant : 

I $moclele= "cor{2}" ; 

recherche des mots contenant les caractères corr. 

Ici encore, le modèle recherché peut être suivi d'autres caractères, y compris celui sur 
lequel s'appliquent les accolades. Les chaînes correcteur, corrigé mais aussi corrr sont 
donc valides. En revanche, corsage ne l'est pas. 

Le motif suivant : 

I $moclele= "cor{l,)" ; 

recherche dans une chaîne la présence des lettres co, suivies d'un nombre quelconque de 
caractères r. Les chaînes cor, corr, corrr, etc., sont donc valides. 

Les fonctions de recherche PHP 

Comme expliqué précédemment, plusieurs extensions PHP permettent d'utiliser des 
expressions régulières et donc plusieurs séries de fonctions utilisables dans ce but. 

Nous nous penchons ici sur les fonctions standards de PHP. 

Les fonctions élémentaires de recherche de PHP sont les suivantes : 

Ibool ereg ( string $modele, string $ch [, array $tab]) 
bool eregi ( string Smodele, string $ch [, array $tab]) 

Elles permettent de contrôler la présence d'une sous-chaîne répondant au motif d'expres- 
sion régulière $model e dans $ch. Le troisième paramètre est un tableau indicé qui contient 
la chaîne $ch dans l'élément d'indice 0 ainsi que les sous-chaînes répondant au modèle 
dans les éléments suivants. Elles retournent TRUE si le motif est trouvé et FALSE dans le cas 
contraire. La seule différence entre ces deux fonctions est que eregO est sensible à la 
casse alors que eregi ( ) ne l'est pas. 
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L'exemple 4-9 constitue votre première application pratique. La définition du motif 
(repère O) exige la présence de quatre chiffres (code ([[:digit:]]{4))), suivis d'un 
nombre quelconque de caractères (code ( .*)). L'utilisation de la fonction eregO permet 
de valider ce motif (repère 0). Si la chaîne $ch contient le motif, un message est affiché 
(repère 0). L'utilisation du tableau $tab permet ensuite de récupérer et d'afficher la date 
(repère ©) et l'événement (repère 0). Dans le cas contraire un message indique la non- 
conformité du motif recherché (repère 0). 

'•^ Exemple 4-9. Recherche dans une chaîne 

<?php 

$ch="1789 Prise de la Bastille": 
$modele= " ( [[ :digi t : ]] (4) ) ( .*) <-© 
if(ereg($modele,$ch,$tab)) <— 0 
{ 

echo "La chaîne \"$ch\" est conforme au modèle \"$modele\" <br />";<— 0 
echo "Date : " , $tab[l] , "<br />":<-© 
echo "Evénement : " ,$tab[2] , "<br />";<— 0 

} 

else echo "La chaîne \"$ch\" n'est pas conforme au modèle \"$modele\" " ; <— 0 
?> 

L'exemple affiche le résultat suivant : 



La chaîne "1789 Prise de la Bastille" est conforme au modèle "( [[ idigit: ]] {4} ) ( .*) " 
Date : 1789 

Evénement : Prise de la Bastille 



Les fonctions suivantes permettent de réaliser des opérations de remplacement d'une 
sous-chaîne conforme à un motif défini par une autre chaîne. Elles retournent une chaîne 
modifiée, mais la chaîne initiale $ch reste intacte (à nouveau, la seule différence entre les 
deux fonctions est que eregi^repl ace( ) est insensible à la casse) : 

Istring ereg_replace ( string $modele, string $remp, string $ch) 
string eregi_repl ace ( string $modele, string $remp, string $ch) 

L'exemple 4-10 utilise ces fonctions. La première remplace un chiffre défini par le 
motif [ [ : di gi t : ] ] par le chiffre 5 (repère 0). Toutes les occurrences de ce chiffre sont 
remplacées. La deuxième remplace un mot par un autre (repère 0) ou le caractère de 
saut de ligne \n par l'élément XHTML <br /> (repère 0). La suivante effectue deux 
remplacements successifs dans la même chaîne (repères 0 et 0). La dernière montre 
que la chaîne de remplacement peut être définie par une fonction à condition qu'elle 
retourne une valeur de type string. Ici, n'importe quel groupe de quatre chiffres défini par 
le motif [0-9] (4) (typiquement une année) est remplacé par la chaîne 2004 (repère 0). 

'•^ Exemple 4-1 0. Remplacement de sous-chaînes 

|<?php 
" 
$ch = "La 4e \n version est PHP 4:\n Viva PHP4": 
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$ch2=ereg_repl ace ("[[:digit:]]", "5", $ch):<— © 
echo $ch2,"<br />"; 

echo ereg_replace (" est", " fut", $ch),"<br />" ; <— © 
echo ereg_replace ("\n", "<br />", $ch2),"<br />";<—© 
echo $ch, "<br />" ; ; 

// 

$ch = "Quatre mariages et un enterrement "; 
$ch2=eregi_repl ace ("MARIAGE", "divorce", $ch);<— © 
$ch2=ereg_repl ace ("enterrement", "mariage", $ch2);<— @ 
echo $ch2,"<br />"; 

// 

$ch = "Nous sommes en 2003 "; 

echo ereg_replace ("[0-9]{4}", date("Y"), $ch);<— 0 
?> 

L'exemple affiche le résultat suivant : 



La 5e version est PHP 5: Viva PHP5 
La 4e version fut PHP 4: Viva PHP4 
La 5e 

version est PHP 5: 
Viva PHP5 

La 4e version est PHP 4: Viva PHP4 
Quatre divorces et un mariage 
Nous sommes en 2004 



Définition d'un motif complexe 

Vous allez maintenant aborder la manière de créer des modèles complexes afin de réali- 
ser des recherches ou des validations d'expressions complexes, comme des montants 
financiers ou des adresses e-mail. 

Elle consiste à combiner les différentes possibilités que vous avez découvertes à la 
section précédente. 



Validation d'un nom 

En prenant pour hypothèse qu'un nom de famille est composé uniquement de lettres et 
des caractères apostrophes (') et tiret (-) pour les prénoms composés, à l'exclusion de 
tout autre, vous créez le modèle suivant : 

I $modele=""([a-zA-Z])([- a-zA-Z]*)$"; 

II ne recherche que les noms commençant par des lettres suivies éventuellement d'un 
tiret, d'une espace et de lettres, ces caractères devant constituer la fin du nom. Les chiffres 
et les autres caractères sont exclus. 

L'exemple 4-11 affiche un message si le nom ne correspond pas à ces critères. 
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Exemple 4-1 1 . Validation d'un nom complet 

<?php 

$modele="'^([a-zA-Z])([- a-zA-Z]*)$": 
$nom="Jean-Paul DEUX"; 
if ( leregi ($model e.Snom) ) 

{echo "Le nom \"$nom\" n'est pas conforme. Veuillez le ressaisir!";) 
?> 

Le nom Jean-Paul Deux est accepté, mais pas Jean-Paul 2. Ce script peut être utilisé pour 
vérifier les saisies effectuées dans un formulaire avant l'enregistrement des données. 

Valider une adresse e-mail 

Vous cherchez maintenant à valider une adresse e-mail saisie par un utilisateur. 

Les adresses valides sont de la forme : 

nom@dDmaine.uk 
prenom.nom@domaine.com 
prenom-nom@domai ne . i nf o 

Les extensions des domaines sont limitées à quatre caractères. 

Le modèle suivant est beaucoup plus complexe que les précédents : 

I Smodele^'CCa-zljCCa-zO-gD+CX. |-)?([a-z0-9]+)@([a-z0-9]+)\.([a-z] {2,4}$)"; 

II oblige l'adresse à commencer par des lettres (partie CCa-z])), suivies de un ou 
plusieurs caractères alphanumériques (partie ([a-z0-9])+) puis d'un point ou d'un tiret 
optionnels (partie (\. | -)?)). Le groupe de caractères suivant peut être alphanumérique 
(partie ( [a-z0-9]+)). La présence du caractère @ est obligatoire. Il doit être suivi d'au moins 
deux caractères alphanumériques représentant le nom de domaine (partie ( [a-zO-9] {2 , } )). 
La présence d'un point puis d'une extension alphabétique de deux à quatre lettres doit 
terminer l'adresse (partie \ .([a-z]{2,4)$)) pour être valide. 

Le script de l'exemple 4-12 utilise ce motif pour créer une fonction de validation 
(repère Q)- Le paramètre unique $ch représente l'adresse à vérifier. L'adresse est d'abord 
convertie en minuscules (repère©), puis la fonction eregO vérifie la conformité de 
l'adresse au motif (repère 0). Selon le cas, la fonction affiche le message adéquat et 
retourne TRUE ou FALSE. 

Exemple 4-1 2. Validation d'une adresse e-mail 

<?php 

//Création de la fonction de validation 

function val idmail ($ch) <— © 

{ 

$modele="("[a-z])([a-z0-9])+(\. |-)?([a-z0-9]+)@([a-z0-9]{2.})\.([a-z]{2,4)$)"; 
$ch=strtolower($ch) ; <-© 
if (ereg($modele, $ch))<— 0 
{ 

echo "$ch est valide <br />"; 
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return TRUE; 

} 

el se 
{ 

echo "$ch est invalide <br />"; 
return FALSE; 

) 

) 

//Utilisation de la fonction de validation 
$mai 1 ="Jean5.dupont@l aposte2.uk" ; 
$mai 1 2="5pierre.dupapi@pl usl oin. info" ; 
$mai 13="engel s-jean@funphp.coin" ; 
validmail ($mail ) ; 
validmail ($mail2) ; 
validmail ($mail3) ; 
?> 

Le résultat affiché est le suivant : 



jean5.dupont@laposte2.net est valide 
5pierre.dupap@plusloin.info est invalide 



Mémo des fonctions 

string addslashes(string str) 
Ajoute des antislashs dans une chaîne. 

string chLink_spl it(string $ch , int N , string $fin) 
Scinde une chaîne en introduisant la chaîne $f i n tous les N caractères, 
string crypt(string $ch [, string $sel]) 
Crypte la chaîne $ch à l'aide de $sel . 

void echo string $chl string $chN 

Affiche une ou plusieurs chaînes de caractères. 

array explode(string $sep . string $ch [, int N]) 

Transforme une chaîne en tableau indicé d'au maximum N éléments en utilisant le caractère $sep comme critère de coupure, 
string titiiil_entity_decode(string $cti , int CTE[, string charset]]) 
Convertit toutes les entités XHTML en caractères normaux. 

string titmlentities(string string , int quote_style , string charset) 
Convertit tous les caractères en entités XHTML. 

string html spécial chars(string string . int quote_style , string charset) 
Convertit les caractères spéciaux en entités XHTML. 
string implode(string $sep , array $tab) 

Réunit tous les éléments d'un tableau dans une chaîne en les séparant par le caractère $sep. 
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string ltrim(string $ch [, string $liste]) 

Supprime tous les caractères d'espace en début de ctiaîne ou seulement ceux qui sont iistés dans $1 i ste. 
string nl2br(stn'ng $ch) 

Rempiace les sauts de ligne \n par l'élément XHTML <br />. 

int ord(string $ch) 

Retourne le code ASCII du caractère $cti. 

int print(string $ch) 

Affiche une chaîne de caractères. 

void printf (string "format" , string $chl , . . .$chN) 

Affiche des chaînes de caractères formatées à l'aide de caractères spéciaux. 

string quotemeta(string $ch) 

Échappe les caractères ., \, +,*,?,[,],(,),$ et 

string rtrim(string $ch [, string $liste]) 

Supprime tous les caractères d'espace en fin de chaîne ou seulement ceux qui sont listés dans $1 1 ste. 
int siiiiilar_text(string $chl , string $cti2 [, $pourcent]) 

Calcule la similarité de deux chaînes en nombre de caractères ou en pourcentage retourné dans la variable $pourcent. 

string sprintf (string "format" . string $chl, string $ch2,... $chN) 

Retourne une chaîne formatée contenant les variables $chl à $ctiN. 

divers sscanf (string $ch , string "format" [, string $chl $ctiN]) 

Décompose une chaîne selon un format donné et retourne ses éléments dans un tableau ou dans les variables $ctil 
à $ctiN. 

mixed str_i repl ace(mixed search , mixed replace , mixed subject , int &count) 
Version insensible à la casse de str_repl ace( ). 

string str_pad(string input , int pad_lengtli , string pad_string , int pad_type) 

Complète une chaîne jusqu'à une taille donnée. 

string str_repeat(string input , int multiplier) 

Répète une chaîne. 

mixed str_replace(string $chl, string $ch2, string $ch [.string $var]) 

Remplace toutes les occurrences de $chl par $ch2 dans une chaîne $ch. Le nombre de remplacement est contenu 
dans $var. 

string str_stiuffle(string $cti) 

Mélange aléatoirement les caractères d'une chaîne de $ch. 

array str_spl i t(string $ch [, int N]) 

Convertit une chaîne de caractères en tableau dont chaque élément a N caractères (1 par défaut). 

mixed str_word_count(string $ch) 

Retourne le nombre de mots présents dans une chaîne. 
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int strcasecmp(string $chl , string $ch2) 
Compare les chaînes $chl et $ch2 (sensible à la casse), 
string strip_tags(string $ch [, string $liste]) 

Supprime les balises XHTML et PHP d'une ctiaîne, sauf celles qui sont contenues dans la chaîne $1 i ste. 
int 5tripos(string tiaystack , string needle , int offset) 
Version insensible à la casse de strpos( ). 
string stripslasties(string $ch) 

Supprime les antislashs d'une chaîne et retourne la chaîne nettoyée. 

string stristr(string $ch , string $ch2) 

Version insensible à la casse de strstr( ). 

int strlen(string $cti) 

Retourne la taille d'une chaîne. 

int strnatcasecmpCstring $cti, string $cti2) 

Comparaison de chaînes avec l'algorithme d'ordre naturel mais insensible à la casse. 

int strnatcmpCstring strl , string str2) 

Comparaison de chaînes avec l'algorithme d'ordre naturel. 

int strncasecmp(string $ch, string $ch2, int N) 

Compare en binaire des chaînes de caractères. 

int strncmpCstring $ch, string $ch2, int N) 

Compare en binaire les n premiers caractères. 

array strpbrkCstring $cti, string $cti2) 

Recherche une chaîne de caractères dans un ensemble de caractères. 

int strpos(string $ch, string $ch, int offset) 

Trouve la position d'un caractère dans une chaîne. 

string strrchr(string $ch, char needle) 

Trouve la dernière occurrence d'un caractère dans une chaîne. 

string strrevCstring $cti) 

Inverse une chaîne. 

int strripos(string $ch, string $ch, int offset) 

Trouve la position de la dernière occurrence d'une chaîne dans une autre de façon insensible à la casse. 

int strrpos(string $cfi, string $ch. int offset) 

Trouve la position de la dernière occurrence d'un caractère dans une chaîne. 

int strspn(string $ch, string $ch2, int start , int length) 

Trouve le premier segment d'une chaîne. 
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string strstr(string $ch, string $ch2) 

Recherche la première occurrence dans une chaîne $ch2 dans $ch et retourne tous les caractères de $ch2 compris à la 
fin de la chaîne $ch. 

string strtolower(string $ch) 

Retourne $cti en minuscules. 

string strtoupper(string $ch) 

Retourne $cti en majuscules. 

string strtr(string $ch, string $listel . string liste2) 

Remplace les caractères de $1 i stel par ceux de $1 i ste2 dans une chaîne $ch. 

int substr_count(string $ch, string $ch) 

Retourne le nombre d'occurrences de $cli2 dans la chaîne $ch. 

string substr(string $ch, int ind , int N) 

Retourne la chaîne contenant N caractères de $ch extraits à partir de l'indice i nd. Si le paramètre W est omis, retourne 
la sous-chaîne comprise entre l'indice ind et la fin de $ch. 

string trim(string $ch [, string liste]) 

Supprime tous les caractères d'espace en début et en fin de chaîne ou seulement ceux qui sont listés dans $1 i ste. 

string ucfi rst(string $ch) 

Retourne $ch avec le premier caractère en majuscule. 

string ucwords(string $ch) 

Retourne $ch avec le premier caractère de chaque mot en majuscule. 

void vprintf (string "format" , array $tab) 

Affiche une chaîne formatée composée des éléments du tableau $tab. 

string vsprintf (string format , array $tab) 

Retourne une chaîne formatée composée des éléments du tableau $tab. 

string wordwrap(string $ch [, int N [, string car [, boolean coupe]]]) 

Réalise la césure de $ch tous les N caractères, car contient la chaîne à insérer dans $ch tous les N caractères. Le para- 
mètre booléen coupe, s'il vaut TRUE, permet d'effectuer une césure des mots dont la longueur dépasse N caractères. 



Exercices 

Exercice 1 

Transformez une chaîne écrite dans des casses différentes afin que chaque mot ait une 
initiale en majuscule. 

Exercice 2 

En utilisant la fonction strl en () , écrivez une boucle qui affiche chaque lettre de la chaîne 
PHP 5 sur une ligne différente. 
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Exercice 3 

Formatez l'affichage d'une suite de chaînes contenant des noms et prénoms en respectant 
les critères suivants : un prénom et un nom par ligne affichés sur 20 caractères ; toutes les 
initiales des mots doivent se superposer verticalement. 

Exercice 4 

Utilisez les fonctions adéquates afin que la chaîne <form action="scnpt.php"> soit affi- 
chée telle quelle et non comme du code XHTML. 

Exercice 5 

A partir de deux chaînes quelconques contenues dans des variables, effectuez une 
comparaison entre elles pour pouvoir les afficher en ordre alphabétique naturel. 

Exercice 6 

Effectuez une censure sur des textes en n'affichant pas ceux qui contiennent le mot zut. 
Exercice 7 

Créez une fonction de validation d'une adresse HTTP ou FTP en vous inspirant de 
l'exemple 4-13. 

Exercice 8 

Créez une expression régulière pour valider un âge inférieur à 100 ans. 
Exercice 9 

Dans la chaîne PHP 5 \n est meilleur \n que ASP \n et JSP \n réuni s, remplacez les 
caractères \n par <br /> en utilisant deux méthodes différentes (une fonction ou une 
expression régulière). 
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Comme expliqué au chapitre 3, consacré aux types de données accessibles dans PHP, les 
tableaux représentés par le type array sont d'une utilisation courante dans les scripts. La 
possibilité de stocker un grand nombre de valeurs sous un seul nom de variable offre 
des avantages appréciables, notamment une grande souplesse dans la manipulation des 
données. Les nombreuses fonctions natives de PHP applicables aux tableaux permettent 
les opérations les plus diverses dans la gestion des tableaux. 

Dans ce chapitre, vous verrez : 

• les différentes façons de créer des tableaux ; 

• les méthodes de lecture des éléments de tableau ; 

• les fonctions de manipulation des tableaux. 

Créer des tableaux 

La fonction array () 

La fonction array( ) permet de créer de manière rapide des tableaux indicés ou associa- 
tifs. C'est elle qui sera le plus souvent utilisée pour la création de tableaux. 

Les tableaux indicés 

La façon la plus élémentaire de créer un tableau indicé consiste à définir individuelle- 
ment une valeur pour chacun des ses éléments, et ce de la manière suivante : 

I $tab[n] = valeur; 
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où n est un indice entier quelconque, et valeur un scalaire ou une variable de type i nteger, 
double, boolean, string ou array. 

Cette manière de procéder se révèle rapidement rébarbative dès qu'il s'agit de définir un 
nombre plus important d'éléments. Pour créer un tableau composé de plusieurs éléments 
en une seule opération, vous disposez heureusement de la fonction array (), dont la 
syntaxe est la suivante : 

I $tab = array(valeurO,valeurl valeurN) 

La variable $tab est ici un tableau indicé dont les valeurs d'indice varient de 0 à N. Ce 
tableau a donc N + 1 éléments, accessibles par la notation habituelle $tab[0], $tab[l], . . ., 
$tab[N], dont les valeurs respectives peuvent avoir l'un quelconque des types précités. 



Premier indice 

Avec ce mode de création de tableau, le premier indice a, une fois encore, toujours la valeur 0 . Il ne faut 
pas oublier d'en tenir compte lors des opérations de lecture des éléments. 



Les tableaux associatifs 

La même fonction arrayC ) permet aussi de créer rapidement un tableau associatif en défi- 
nissant pour chacun de ses éléments une clé et une valeur. 

La syntaxe de la fonction array( ) est la suivante : 

I $tabasso = arrayC "cl éA"=>val eurA, "cléB"=>valeurB,... "cl éZ"=>val eurZ) 

Comme vous l'avez vu au chapitre 2, chaque clé est une chaîne de caractères délimitée 
par des guillemets. 

Pour lire val eurA, vous écrivez : 

I $tabasso["cléA"] 

de la même façon que lorsque chaque élément est créé individuellement. 

Dans un tableau associatif, la notion d'ordre des éléments perd la valeur qu'elle peut 
avoir dans un tableau indicé. Les clés ne sont pas numérotées, par exemple. Vous pourriez 
énumérer clés et valeurs dans un ordre différent sans que cela gène la lecture individuelle 
de chaque élément. 

Vous auriez donc pu créer le même tableau en écrivant : 

I $tabasso = array("cléZ"=>valeurZ, "cléY"=>valeurY,... "cl éA"=>val eurA) 

qui correspond à l'ordre inverse. Vous pouvez en fait effectuer la création dans un ordre 
quelconque, sans changer quoi que ce soit à l'accès aux valeurs à l'aide de leur clé. Cela 
confirme la souplesse d'utilisation des tableaux associatifs en comparaison des tableaux 
indicés. Cette souplesse se révèle particulièrement utile dans les opérations de suppres- 
sion d'éléments ou de tri sur des tableaux, lesquelles peuvent faire perdre les associations 
entre indices et valeurs. 
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Les tableaux multidimensionnels 

Contrairement aux langages dans lesquels vous déclarez les variables et leur type, 
comme ASP.Net utilisé avec C#, PHP ne comporte pas de méthode explicite de création 
de tableaux multidimensionnels. C'est tout l'avantage de ce langage que d'autoriser 
qu'un élément de tableau puisse être un tableau lui-même. La création de tableau 
comportant un nombre quelconque de dimension en est d'autant facilitée. 

Un tableau multidimensionnel est similaire à une matrice, au sens mathématique du 
terme. La structure d'un tableau à deux dimensions peut se représenter sous la forme 
d'un tableau à double entrée, comme l'exprime le listing de l'exemple 5-1, dont le résul- 
tat est illustré à la figure 5-1. 
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Tableau multidimensionnel 
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.. ligne 0-coIonne 0 .. 


.. ligne 0-colonne 1 .. 


.. ligne 0-colonne 2 .. 


.. ligne 1-coIonne 0 .. 


.. ligne 1 colonne 1 .. 


.. ligne 1-colonne 2 .. 


.. ligne 2-colonne 0 .. 


.. ligne 2-colonne 1 .. 


.. ligne 2-colonne 2 .. 


.. ligne 3-coIonne 0 .. 


.. ligne 3-coionne 1 .. 


„ ligne 3-colonne 2 .. 



Figure 5-1 

Visualisation d'un tableau multidimensionnel 



Les valeurs des éléments ont été choisies de manière à montrer clairement par la suite 
comment accéder à une valeur particulière. Le premier chiffre est celui de la ligne, et le 
second celui de la colonne. Chaque ligne est à la fois un élément du tableau principal, qui 
contient quatre éléments, et est elle-même un tableau à trois éléments. 

Vous obtenez au total douze valeurs dans le tableau, mais il n'a que quatre éléments. 

De même que pour repérer un élément dans un espace à n dimensions il faut utiliser 
coordonnées, pour lire une valeur dans un tableau à n dimensions, il faut utiliser indi- 
ces, ou clés, différents. 

Par exemple, pour récupérer dans la variable $a la deuxième valeur (indice 1) de la troi- 
sième ligne (indice 2) du tableau précédent Stabmulti, écrivez : 



I $a = $tabmulti[2][l] 
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Dans cet exemple, chaque élément du tableau est un tableau ayant autant d'éléments 
que les autres, ce qui réalise une matrice rectangulaire 4 x 3. Il est évidemment possi- 
ble de créer des tableaux multidimensionnels non symétriques, dans lesquels le 
premier élément pourrait être, par exemple, une valeur entière ou une chaîne de carac- 
tères, le deuxième élément un tableau à dix éléments, le troisième un tableau avec un 
nombre d'éléments différents puis tout autre combinaison possible. Quoique parfaite- 
ment réalisable, ce type de tableau, qui est irrégulier, risque de se révéler difficile à lire 
avec une boucle, comme vous le verrez dans les exemples présentés dans la suite du 
chapitre. 



Pour en savoir plus 

Les boucles sont abordées en détail au chapitre 3. 



Le listing 5-1 utilise deux boucles de lecture pour afficher le contenu du tableau. Vous 
pouvez très bien envisager de créer de la même façon des tableaux à trois, quatre dimen- 
sions et bien plus encore, mais la visualisation en devient vite difficile. 

Pour créer le tableau de la figure 5-1, utilisez la fonction array( ) de la façon suivante : 

$tabmulti=array( 

array("ligne 0-colonne 0", "ligne 0-colonne 1", "ligne 0-colonne 2"), 
arrayCligne 1-colonne 0", "ligne 1-colonne 1", "ligne 1-colonne 2"), 
arrayCligne 2-colonne 0", "ligne 2-colonne 1", "ligne 2-colonne 2"), 
array("ligne 3-colonne 0", "ligne 3-colonne 1", "ligne 3-colonne 2") 
); 

Afin de visualiser la structure complète du tableau $tabmulti , vous pouvez, dans les 
phases de test des scripts, utiliser la fonction print_r($tabmulti ), qui affiche la structure 
suivante : 



Array ( 

[0] Array ( [0] ligne 0-colonne 0 [1] => ligne 0-colonne 1 [2] => ligne 0-colonne 
2 ) 

[1] => Array ( [0] ligne 1-colonne 0 [1] => ligne 1-colonne 1 [2] => ligne 1-colonne 
2 ) 

[2] Array ( [0] ligne 2-colonne 0 [1] => ligne 2-colonne 1 [2] => ligne 2-colonne 
2 ) 

[3] => Array ( [0] => ligne 3-colonne 0 [1] => ligne 3-colonne 1 [2] => ligne 3-colonne 

2 ) ) 



Vous retrouvez bien les différents éléments du tableau et leur contenu. 

La fonction var_dump($tabmulti ) permet d'afficher un ensemble d'informations encore 
plus complètes sur le tableau. Elle donne le nombre d'éléments et la description de 
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chacun d'eux, ainsi que le type et le contenu de chaque valeur. Vous obtenez ainsi pour le 
même tableau : 



array(4) { [0]=> arrayO) { [0]=> stringd?) "ligne 0-colonne 0" [1]=> string(17) 
"ligne 0-colonne 1" [2]=> stringd?) "ligne 0-colonne 2" } 

[1]=> arrayO) { [0]=> stringd?) "ligne 1-colonne 0" [1]=> stringd?) "ligne 1-colonne 1" 
[2]=> stringd?) "ligne 1-colonne 2" ) 

[2]=> arrayO) { [0]=> stringd?) "ligne 2-colonne 0" [1]=> stringd?) "ligne 2-colonne 1" 
[2]=> stringd?) "ligne 2-colonne 2" ) 

[3]=> arrayO) { [0]=> stringd?) "ligne 3-colonne 0" [1]=> stringd?) "ligne 3-colonne 1" 
[2]=> stringd?) "ligne 3-colonne 2" ) } 



Dans cette description, array(4) signifie que la variable $tabmulti est un tableau à quatre 
éléments. Vient ensuite la description de tous les éléments sur le même principe. Les 
expressions du type : 

I [0]=> array(3) 

signifient que le premier élément du tableau est lui-même un tableau à trois éléments. 
Les accolades qui suivent donnent le type et la valeur de chacun des éléments de ce 
dernier tableau. Dans la suite de la description, nous trouvons : 

I [0]=> stringd?) "ligne 0-colonne 0" 

qui indique que l'élément d'indice 0 est une chaîne de dix-sept caractères, dont la valeur 
est "ligne 0-colonne 0". 

L'utilisation de ces fonctions sert au programmeur à des fins de débogage des scripts. Il 
serait maladroit de les employer pour créer un affichage à destination de l'utilisateur 
final, qui les trouverait pour le moins obscures et peu « parlantes ». 

Exemple 5-1. Création d'un tableau multidimensionnel 

<?php 

$tabmulti=array(array( "1 igne 0-colonne 0", "ligne 0-colonne 1", "ligne 0-colonne 2"), 

^array("ligne 1-colonne 0", "ligne 1-colonne 1", "ligne 1-colonne 2"), 

^array("ligne 2-colonne 0", "ligne 2-colonne 1", "ligne 2-colonne 2"), 

^array("ligne 3-colonne 0", "ligne 3-colonne 1", "ligne 3-colonne 2")); 

echo "<h3>Tableau multidimensionneK/hSXtable border='r width=\"100% \"> <tboby>": 

for ($i=0:$i<count($tabmLilti ) :$i++) 

{ 

for($j=0:$j<count($tabmulti[$i]) :$j-H-) 

{ 

echo "<td><h3> .. ".$tabmulti[$i][$j]," .. </h3></td>": 
} 

echo "</tr>"; 

} 

echo " </tbody> </table> "; 
?> 

Le résultat obtenu est celui de la figure 5-1. 
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Créer des suites 

Pour créer des tableaux dont les éléments sont des suites de nombres et éventuellement 
de lettres, comme vous le verrez à l'exemple 5-2, vous pourriez envisager d'utiliser une 
boucle for. PHP propose toutefois une fonction rangeO, qui permet de réaliser cette 
opération en une seule ligne de code. Sa syntaxe est la suivante : 

I array rangednt mini.int maxi ) 

Cette fonction retourne un tableau indicé contenant tous les entiers compris entre les 
valeurs mini et maxi. 

Pour créer des suites de lettres, le moyen le plus classique serait d'écrire une boucle utili- 
sant la fonction chr(n), qui retourne le caractère dont le code ASCII est n. Pour créer un 
tableau contenant la suite de lettres de "A" à "Z", vous utiliseriez donc les valeurs de n 
comprises entre 65 et 90, ou 97 et 122 pour la suite de "a" à "z". Au lieu de cela, PHP 
vous permet d'utiliser la fonction range{ ), dont la syntaxe est alors la suivante : 

I $tabalpha = range( "A" , "Z" ) 

Cette possibilité n'est pas mentionnée dans la documentation officielle, d'où l'utilité de 
l'expérimentation personnelle. 



Script de tableau 

Dans les résultats affichés parle script, pour les tableaux créés à l'aide de la fonction range( ), le premier 
Indice est 0 alors qu'avec une boucle for il serait possible de choisir l'indice 1. 

<^ Exemple 5-2. La création de suites 

<?php 

//Suite de nombres de 1 à 10 
$tabnombre= ranged.lO); 
print_r($tabnombre) ; 
echo "<hr>"; 

//Suite de lettres de a à z avec une boucle 

for($i=97:$i<=122:$i-H-) 

{ 

$tabalpha[$i-96]=chr($i ); 

} 

print_r($tabalpha); 
echo "<hr>"; 

//Suite de lettres de A à M avec rangeO 
$tabalpha2 = range( "A" , "M" ) ; 
print_r($tabalpha2) ; 
?> 

Le script de l'exemple 5-2 affiche les résultats suivants : 



Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 [5] 6 [6] => 7 [7] => 8 [8] 
=> 9 [9] => 10 ) 
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Array ( [1] a [2] => b [3] c [4] d [5] => e [6] f [7] g [8] => h [9] 
i [10] j [11] => k [12] 1 [13] => m [14] => n [15] o [16] p [17] q [18] 
r [19] => s [20] => t [21] => u [22] => v [23] w [24] => x [25] => y [26] => z ) 

Array ( [0] A [1] => B [2] => C [3] D [4] => E [5] => F [6] G [7] => H [8] => 
I [9] => J [10] => K [11] => L [12] => M ) 

Créer un tableau à partir d'une chaîne 

Une dernière façon utile de créer des tableaux consiste à décomposer une chaîne de 
caractères en un ensemble de sous-chaînes, dont chacune devient un élément de tableau. 

Le critère de coupure de la chaîne est un caractère quelconque à choisir par le program- 
meur. Cela peut être une espace, pour décomposer une phrase en mots au sens courant du 
terme, ou le caractère pour séparer le nom d'utilisateur de celui de son serveur de 
courrier dans une adresse e-mail. 

Cette opération peut être effectuée très simplement au moyen de la fonction explodeO, 
dont la syntaxe est la suivante : 

I array explodeCstring "coupe" .string $chaine, [int nbmax]) 

Cette fonction retourne un tableau composé des sous-chaînes de $chaine créées avec 
le critère de coupure contenu dans la chaîne "coupe", l'entier nbmax facultatif donnant le 
nombre maximal de sous-chaîne désiré. 

Le code suivant : 

<?php 

$chaine="La cigale et la fourmi"; 
$tabmot = explodeC" ",$chaine); 
print_r($tabmot) ; 
?> 

affiche la structure du tableau $tabmot : 



Array ( [0] La [1] => cigale [2] => et [3] => la [4] => fourmi ) 



En passant comme premier paramètre le caractère "®" , vous pouvez décomposer une 
adresse e-mail avec le code suivant : 

<?php 

$adresse="machin@wanadoo.f r" ; 
$tabsite=expl ode( "@" ,$adresse) ; 

echo "L'utilisateur est : {$tabsite[0] ) et son serveur mail est {$tabsite[l] ) "; 
?> 

qui affiche : 



L'utilisateur est : machin et son serveur mail est wanadoo.fr 
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Compter le nombre de valeurs d'un tableau 

Vous venez de voir la distinction entre le nombre d'éléments d'un tableau et le nombre de 
valeurs qu'il contient. Vous allez maintenant découvrir comment déterminer le nombre 
exact de valeurs d'un tableau. 

Vous avez déjà employé la fonction count( ) pour déterminer le nombre d'éléments d'un 
tableau. Quand un tableau n'a qu'une seule dimension, la valeur obtenue correspond au 
nombre de valeurs contenues dans le tableau. Si le tableau est multidimensionnel, en 
revanche, la valeur retournée par count( ) n'est pas égale au nombre de valeurs. 

L'exemple 5-3 fournit une méthode permettant de déterminer le nombre de valeurs d'un 
tableau à l'aide d'une boucle. Cette dernière examine le type de chacun des six éléments 
du tableau $tabdi v, qui contient des chaînes de caractères, des tableaux et des entiers. 

Si l'un des éléments est un tableau, vous réutilisez la fonction court () pour trouver le 
nombre de valeurs qu'il contient et incrémentez le compteur $nb_val d'autant, sauf pour 
les entiers et les chaînes, pour lesquels vous l'incrémentez d'une unité seulement. Vous 
obtenez de la sorte le nombre total de valeurs. 

Si le tableau avait trois dimensions au lieu de deux, il vous faudrait ajouter une boucle for 
supplémentaire pour arriver au même résultat. 

Le listing de l'exemple 5-3 fournit le résultat suivant : 



Le tableau Stabdiv contient 6 éléments 
Le tableau Stabdiv contient 11 valeurs 



Exemple 5-3. Comptage du nombre de valeurs 

<?php 

//Compte du nombre d'éléments 

$tabdi v=array( "Bon jour", "Web". arrayC 1-0", "1-1 ","1-2"), 1970, 2009. 
^array("3-0","3-l","3-2","3-3")): 

echo "Le tableau \$tabdiv contient " .count($tabdi v) . " éléments <br />"; 
//ou encore: echo "Le tableau \$tabd1v contient " .sizeof ($tabdi v) . " éléments <br />"; 
//Compte du nombre de valeurs 
$nb_val=0: 

for ($i=0:$i<count($tabdiv) ;$i++) 
{ 

if (gettype($tabdi v[$i ] )=="array" ) 

$nb_val+=count($tabdi v[$i ] ) ; 
el se 

$nb_val++: 

} 

echo "Le tableau \$tabdiv contient ".$nb_val." valeurs <br />"; 
?> 
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La fonction sizeofQ 

La fonction sizeof ( ) est un alias de la fonction count( ). Vous pouvez l'employer à la place dans tous 
les exemples précédents. 



Dans le même ordre d'idée, vous pouvez être amené à vouloir compter non pas le nombre 
total de valeurs d'un tableau mais le nombre de valeurs différentes qu'il contient. 

La fonction array_count_val ues( ), dont la syntaxe est la suivante : 

I Sresult = array_count_values($tab) 

retourne le tableau associatif $result, ayant pour clés les valeurs du tableau $tab et pour 
valeur associée à chaque clé le nombre de fois que chacune apparaît dans le tableau $tab. 

Cette fonction peut vous permettre de réaliser une analyse statistique des données conte- 
nues dans un tableau. Cela se révèle pratique lorsque les données sont nombreuses, 
comme après une requête de sélection dans une base de données. 

Le listing 5-4 offre une illustration de l'emploi de cette fonction. La fonction count( ) affi- 
che le nombre d'éléments du tableau $tab. La fonction array_count_values( ) affiche le 
nombre de valeurs différentes que contient le tableau. Enfin, la fonction Sresult donne 
des informations statistiques sur le nombre d'occurrences de chaque valeur. 

'•^ Exemple 5-4. Comptage du nombre de valeurs 

<?php 

$tab= array( "Web", "Internet", "PHP". "JavaScript", "PHP". "ASP", "PHP". "ASP"): 
$result=array_coLint_val ues($tab) : 

echo "Le tableau \$tab contient " .count($tab) . " éléments <br>": 

echo "Le tableau \$tab contient " ,count($resul t) , " valeurs différentes <br>"; 

print_r($result) ; 

?> 

Le listing de l'exemple 5-4 fournit le résultat suivant : 



Le tableau $tab contient 8 éléments 

Le tableau $tab contient 5 valeurs différentes 

Array ( [Web] => 1 [Internet] => 1 [PHP] => 3 [Javascript] 1 [ASP] => 2 ) 



La fonction array_count_values() 

La fonction a rray_count_val ues ( ) ne s'applique que si les éléments sont de type i nteger, double ou 
string mais pas de type array. Elle n'est pas adaptée pour compter le nombre de valeurs d'un tableau 
multidimensionnel. 



En comparaison des fonctions print_r{ ) et var_dump( ), que vous avez utilisées pour affi- 
cher l'ensemble des éléments d'un tableau, les boucles de lecture des éléments de 
tableau, de leur indice et de leur clé offrent un meilleur affichage, sous forme de tableau 
XHTML, par exemple. 



112 



PHP 5 



Ce sont ces méthodes que vous mettrez en pratique dans les sections suivantes et dans la 
suite de l'ouvrage pour lire les données d'un tableau et les restituer dans des pages 
XHTML. 

Lire les éléments des tableaux 

Comme vous venez de le voir, il est souvent utile d'afficher l'ensemble des informations 
contenues dans un tableau, que ce soit la valeur des éléments qu'il contient ou les couples 
indice -valeur et clé-valeur des tableaux respectivement indicés ou associatifs. 

Cette section présente un large éventail des possibilités de lecture des tableaux. Ces 
dernières répondent à tous les besoins, y compris la lecture intégrale des tableaux multi- 
dimensionnels. 

Lire avec une boucle for 

La boucle for a besoin d'un paramètre d'arrêt. Vous allez employer pour cela la fonction 
count( ), qui retourne le nombre total d'éléments de la boucle. L'utilisation de la variable 
$i comme compteur de la boucle permet de parcourir l'ensemble des valeurs du tableau 
unidimensionnel. 

Le listing de l'exemple 5-5 donne un exemple de lecture d'un tableau indicé. 
Exemple 5-5. Lecture d'un tableau indicé à l'aide de la boucle for 

<?php 

$inontab=array( "Paris" , "London" , "Brûssel " ) ; 
for ($i=0:$i<count($inontab) :$i++) 
{ echo "L'élément $i est $montab[$i ]<br />";) 

1 

Le listing fournit le résultat suivant : 

L'élément 0 est Paris 
L'élément 1 est London 
L'élément 2 est Briissel 



La boucle for peut permettre la lecture de tableaux multidimensionnels, à condition 
d'écrire autant de niveaux de boucles qu'il y a de dimensions dans le tableau. 

Le listing de l'exemple 5-6 donne un exemple de lecture de ce type de tableau à l'aide de 
deux boucles imbriquées. La première parcourt les éléments du tableau $cl ients à l'aide 
d'un compteur $i . Comme chacun de ces éléments est un tableau, la seconde boucle 
de compteur $j lit l'ensemble des éléments contenus dans ces tableaux. 

L'affichage s'effectue sous la forme d'un tableau XHTML avec en-tête et pied à l'aide 
des éléments XHTML <thead> et <tf oot>. Ces derniers sont très utiles pour améliorer la 
présentation des tableaux, notamment des longs tableaux. 
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<^ Exemple 5-6. Lecture d'un tableau multidimensionnel indicé à l'aide de la 
boucle for 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture d'un tableau indicé avec une boucle for</title> 
</head> 
<body> 
<div> 
<?php 

//Création du tableau 

$clients = array(array ("Leparc", "Paris", "35"), array("Duroc","Vincennes", "22"), 
array( "Denoël " , "Saint Cloud" , "47" ) ) ; 
/*A1 ternati ve à la création du même tableau 
$tabl= array("Leparc", "Paris", "35") : 
$tab2= array( "Duroc" , "Vincennes" , "22" ) ; 
$tab3= array("Denoël", "Saint Cl oud" , "47" ) ; 
$clients=array($tabl,$tab2,$tab3) ; */ 
echo "<table border=\"l\" width=\"100%\" >"; 
//En tête du tableau 

echo "<thead><tr> <th> Client </th><th> Nom </th><th> Ville </th><th> Age </th></tr> 
^</thead>" ; 
//Pied de tableau 

echo "<tfoot> <tr><th> Client </th><th> Nom </th><th> Ville </th><th> Age </th></tr> 

^</tfoot><tbody>" ; 

//Lecture des indices et des valeurs 

for ($i=0;$i<count($clients) :$i++) 

{ 

echo "<tr><td align=\"center\"><b>$i </b></td>": 
for($j=0:$j<count($clients[$i]) :$j++) 

{ 

echo "<td><b>",$clients[$i][$j]," </b></td>": 

} 

echo "</tr>"; 

} 

?> 

</tbody> 

</table> 

</div> 

</body> 

</html> 
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^ Lecture d'un tableau indicé avec une boucle for - Mozilla Firefox 



bchier bdition Attichage Historique Marque-pages Uutils i 

c 



http://www.funhtml.com/php5/C5tableauK/tableau6.php 



"u? ' I jtCj'l google earth 




L 


Client 


1 Nom 


I VUle 




Age 


1 


0 


jLeparc 


jParis 


[35 




L 


1 


jOuroc 


|Vincennes 


|22 




L 


2 


jDeDoël 


jSaÏDt Cloud 


|47 






CBent 


Il Non 


Il vaie 




Age 1 



Figure 5-2 

Lecture d'un tableau à deux dimensions et affichage sous forme de tableau XHTML 



Lire avec une boucle while 

La boucle for nécessite par définition de connaître le nombre d'itérations à effectuer tel 
que fourni par la fonction count( ). Ce n'est pas le cas avec la boucle whi 1 e, qui se révèle 
de ce fait plus efficace dans le cas d'un tableau retourné après une requête sur une base 
de données, le nombre de réponses étant bien évidemment inconnu. 

Pour un tableau à une seule dimension, l'expression booléenne contenue dans l'instruc- 
tion while est i sset( $tab[$i ] ). Cette expression prend la valeur TRUE tant que l'élément 
désigné par $tab[$i ] existe. Sinon, elle prend la valeur FALSE, ce qui est le cas en fin de 
tableau. 

La variable $i étant incrémentée dans la boucle, isset($tab[$i]) prend la valeur FALSE 
quand $i dépasse le nombre d'éléments du tableau $tab, ce qui provoque l'arrêt de la 
boucle. 

Par précaution, vous pouvez initialiser la variable $i à 0 avant de démarrer la boucle de 
lecture au cas où elle aurait été utilisée auparavant dans le script et conserverait une 
valeur. L'exemple 5-7 illustre la lecture d'un tableau indicé à une dimension qui fournit 
le même affichage que le listing de l'exemple 5-5. 

Exemple 5-7. Lecture d'un tableau indicé à l'aide de la boucle while 

<?php 

$montab=array( "Paris" . "London" , "Briissel " ) ; 
$i=0: 

while(isset($montab[$i]) ) 
{ 

echo "L'élément $i est $montab[$i ]<br />"; 

$1++; 

} 

?> 
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Si le tableau est multidimensionnel, vous opérez de même au moyen de deux boucles 
whi le imbriquées. L'expression booléenne de la seconde boucle est isset($tab[$i] [$j] ). 
Elle est évaluée de la même façon que précédemment. 

Le compteur $j du nombre d'éléments est également initialisé à 0 avant le début de la 
boucle — c'est ici indispensable pour pouvoir lire les lignes suivantes — et est incré- 
menté après chaque affichage d'un élément. 

Exemple 5-8. Lecture d'un tableau indicé multidimensionnel à l'aide de la 
boucle while 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<htnil xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<title>Lecture d'un tableau indicé avec une boucle while</title> 
</head> 
<body> 
<div> 
<?php 

//création du tableau 

$clients = array(array ("Leparc", "Paris", "35"), array( "Duroc" , "Vincennes", "22"), 
array( "Denoël ", "Saint Cl oud" , "47" ) ) ; 

//Ajout d'un élément 

$clients[7] = array( "Duval " , "Marsei 1 1 e" , "76" ) ; 

//création du tableau HTML 

echo "<table border=\"l\" width=\"100%\" ><thead><tr> <th> Client </th><th> Nom 
^</th><th> Ville </th><th> Age </th></tr></thead> <tfoot> <tr><th> Client </th> 
^<th> Nom </th><th> Ville </th><th> Age </th></tr></tfoot><tbody>" ; 
//Lecture des éléments 
$i=0; 

whi 1 e( i sset($cl ients[$i ] ) ) 
{ 

echo "<tr><td align=\"center\"><b>$i </b></td>": 
$j-0: 

while(isset($clients[$i][$j])) 
{ 

echo "<td><b>",$clients[$i][$j]," </b></td>": 
$j++; 

) 

echo "</tr>"; 
$i++: 

} 

?> 

</tbody> </table> 

</div> 

</body> 

</html> 
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Le résultat de l'exemple 5-8 est identique à celui de la figure 5-2 réalisé avec une boucle for. 



Indice non consécutif 

Si, après avoir défini le tableau $cl i ents, vous lui ajoutez un élément au moyen de l'instruction : 
$clients[7] = array( "Duval " , "Marsei 1 1 e" , "76" ) ; 

créant ainsi un indice non consécutif aux trois premiers, cet élément n'est pas lu dans la boucle. Cette 
méthode n'est donc pas adaptée à ce cas particulier. 



Lire à l'aide de la fonction eachQ 

Pour pallier l'inconvénient signalé à la remarque précédente, il est possible d'utiliser une 
autre méthode de lecture. Cette dernière fait appel à la fois à une boucle while et à la 
fonction eacli( ), qui reçoit comme paramètre une variable de type array. Cette dernière a 
la particularité de retourner un tableau à quatre éléments qui contient les informations sur 
l'élément courant du tableau passé en paramètre puis de pointer sur l'élément suivant. 

La syntaxe de la fonction each( ) est la suivante : 

I $element = each($tab) 

$tab est le tableau à lire et $el ement le tableau de résultats contenant les informations sur 
l'élément courant de $tab, sous la forme : 

• $el ement[0], qui contient l'indice de l'élément courant. 

• $el ement [1], qui contient la valeur de l'élément courant. 

• $element["key"], qui contient la clé de l'élément courant. 

• $el ement ["val ue"], qui contient la valeur de l'élément courant. 

Les couples $element[0]-$element[l] sont généralement utilisés pour récupérer les 
couples indice-valeur des tableaux indicés, et les couples $element["key"]-$element 
["value"] pour récupérer les couples clé-valeur des tableaux associatifs. Cet usage n'a 
toutefois d'autre justification que la force de l'habitude. 

Par exemple, les deux lignes de code suivantes : 

Iecho "L'élément d'indice $element[0] a la valeur $element[l]<br />"; 
echo "L'élément de clé {$element['key']} a la valeur {$el ement[ ' val ue ' ] )<br />"; 

affichent exactement le même résultat. 

L'expression $element=each($tab) étant évaluée à TRUE tant que le tableau contient des 
éléments, placez-la dans une boucle wlii 1 e de façon à pouvoir lire l'ensemble des éléments. 
Arrivé à la fin du tableau, cette expression prend la valeur FALSE, ce qui arrête la boucle. 

Pour vous assurer que le pointeur interne du tableau est positionné au début du tableau, 
vous pouvez appeler la fonction reset( ), dont c'est le rôle, en utilisant comme paramètre 
le tableau à lire avant de commencer la lecture. L'avantage principal de cette méthode de 
lecture est de donner accès aussi bien à des tableaux indicés qu'à des tableaux associatifs. 
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Comme vous pouvez le constater au listing 5-9, l'ajout d'un élément après la création du 
tableau, en particulier avec un indice non consécutif aux précédents, ne perturbe pas la 
lecture de l'intégralité du tableau, à la différence de l'exemple 5-8. 



La notation {$element['key']} 

Dans le listing 5.9, la notation {$element[ ' key ' ]} permet que l'élément soit évalué à l'intérieur de la 
chaîne de caractères. Le fait d'écrire à la place $el ement[ ' key ' ] provoque une erreur. 

f*' Exemple 5-9. Lecture à l'aide de la fonction each() 

<?php 

//******Lecture d'un tableau indicé****** 

$montab=array( "Paris" , "London" , "Brûssel ") ; //indices 0,1,2 

//Ajout d'un élément au tableau 

$montab[9]="Berl in" ; 

//Lecture des éléments 

reset($montab) ; 

whi 1 e( Sel ement=each( $montab) ) 

{ 

echo "L'élément d'indice $element[0] a la valeur $el ement[l]<br />"; 

//$i++: 

} 

echo "<hr>"; 

//******Lecture d'un tableau associatif****** 

$montab=array( "France"=>"Paris" , "Great Bri tain" =>" London" , "Bel gië"=>"Briissel " ) ; 
//Ajout d'un élément au tableau 
$montab["Deutschl and"]="Berl in" ; 

//Lecture des éléments 

reset($montab) ; 

whi 1 e( Sel ement=each( $montab) ) 

{ 

echo "L'élément de clé {$element['key']} a la valeur {$element['value']}<br />"; 

//$i++: 

} 

?> 

Le listing 5-9 affiche le résultat suivant : 



L'élément d'indice 0 a la valeur Paris 

L'élément d'indice 1 a la valeur London 

L'élément d'indice 2 a la valeur Briissel 

L'élément d'indice 9 a la valeur Berlin 

L'élément de clé France a la valeur Paris 

L'élément de clé Great Britain a la valeur London 

L'élément de clé België a la valeur Briissel 

L'élément de clé Deutschland a la valeur Berlin 
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La fonction each( ) offre une lecture encore plus perfectionnée du fait qu'elle s'applique 
à des tableaux multidimensionnels indicés ou même associatifs d'une manière plus 
simple que les méthodes précédentes. 

Il suffit pour cela d'utiliser deux boucles whi 1 e imbriquées. La première récupère les indi- 
ces de chacun des éléments du tableau. Comme chaque élément est lui-même un tableau, 
la seconde récupère les clés et valeurs contenues dans chacun d'eux. 

Le listing 5-10 donne un exemple de lecture de tableaux multidimensionnels, l'un indicé 
et l'autre associatif. Malgré l'ajout d'un élément après la création du tableau, la lecture 
est intégrale. 

<^ Exemple 5-10. Lecture de tableaux multidimensionnels à l'aide de la fonction 
each() 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<titl e>Lecture d'un tableau indicé avec une boucle whi 1 e</titl e> 

</head> 

<body> 

<div> 

<?php 

//Tableau indicé multidimensionnel 

//Création du tableau 

$clients = array( 

array ("Leparc", "Paris", "35"), 

array( "Duroc" , "Vincennes", "22"), 

array( "Denoël " , "Saint Cl oud" , "47" ) ) ; 

//Ajout d'un élément 

$clients[7] = array( "Duval " , "Marsei 1 le" , "76" ) ; 
echo "<table border=\"l\"><tbody>" ; 
while($element=each($clients)) 
{ 

echo "<tr> <td> élément <b> $element[0] </b></td>"; 

while($val=each($element[l] ) ) 

{ 

echo "<td><b>",$val[l]," </b></td>": 

) 

echo "</tr>"; 

} 

echo " </tbody> </table> <hr />"; 



Les tableaux 

Chapitre 5 



j j-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//Tableau associatif multidimensionnel 

j jkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk-kk 

//Création du tableau 
$clients = arrayC 

array( "cl ientl"=>"Leparc" , "vill el"=>"Paris" , "agel"=>"35" ) , 
array( "cl ient2"=>" Duroc" , "vi 1 le2"=>"Vincennes" , "age2"=>"22" ) , 
array( "cl ient3"=>" Denoël " , "vil 1 e3"=>" Saint Cloud" , "age3"=>"47" ) ) ; 
//ajout d'un élément 

$clients[7] = array( "cl ient7"=>"Duval " , "vi 1 1 e7"=>"Marseil 1 e" , "age7"=>"76" ) ; 
echo " <table border=\"l\"><tbody> "; 

//Lecture des éléments 
while($element=each($cl ients) ) 
{ 

echo "<tr><td> élément <b> $element[0] </b></td>": 
whi 1 e($val =each($el ement[l] ) ) 
{ 

echo "<td> clé :<b>" .$val [0] . "</b></td><td><b>" .$val [1] , " </b></td>"; 

} 

echo "</tr>"; 

} 

echo " </tbody> </table>": 
?> 

</div> 
</body> 
</html> 

La figure 5-3 illustre le résultat de ce listing sous la forme d'un tableau XHTML affi- 
chant à la fois les indices, ou les clés selon le cas, et toutes les valeurs contenues dans les 
tableaux $cl ients. 



1^ Lecture d'un Tableau multîdimensîonnel avec eachQ - Mozilla Firefox 
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Figure 5-3 

Lecture de tableaux multidimensionnels à l'aide de la fonction each 
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Lire avec each() et listQ 

La fonction listO pennet d'affecter à A'^ variables la valeur des A'^ premiers éléments d'un 
tableau indicé. Sa syntaxe est la suivante : 

I list($x,$y.$z....) = $tab 

La variable $x prend la valeur du premier élément du tableau $tab (d'indice 0 ou de 
première clé). $y prend la valeur du deuxième élément, et ainsi de suite. 

Le code suivant : 

$tab=array( "Paris" , "London" , "Briissel " ) ; 
list($x,$y) = $tab; 

echo "Les deux premiers éléments sont : $x et $y <br />"; 

affiche uniquement les valeurs "Paris" et "London", sans les indices, qui ne sont pas récu- 
pérés. 

La fonction 1 i st( ) ne déplace pas le pointeur interne du tableau sur les éléments suivants. 
Si vous appelez de nouveau 1 ist($x,$y), vous obtenez les mêmes valeurs. 

L'intérêt de cette fonction dans la lecture des tableaux peut donc paraître limité. Si vous 
l'associez cependant à la fonction each( ), son rôle appréciable devient plus évident. En 
effet, eachO déplace le pointeur interne sur les éléments suivants, tandis que listO 
permet de lire les deux premiers éléments du tableau retourné par la fonction eachO, 
éléments qui contiennent respectivement l'indice et la valeur du tableau à lire. 

Si vous écrivez le code : 

I list($x,$y) = each($tab) 

la variable $x contient l'indice ou la clé, et $y la valeur associée. 

L'ensemble listO et eachO placé comme expression booléenne dans une boucle while 
vous permet donc de lire l'intégralité du tableau en récupérant les indices, ou les clés 
selon les cas. 

Le listing 5-11 donne un exemple d'utilisation de la fonction 11 st( ) ainsi que de lecture 
de tableaux indicés et associatifs. 



Plusieurs virgules 

Si vous écrivez : 

list($x, ,$y, ,$z) = $tab 

en plaçant plusieurs virgules de suite, $x contient bien le premier élément de $tab, mais $y contient le 
troisième et $z le cinquième. Cette particularité peut se révéler utile, par exemple, pour ne récupérer que 
les éléments d'indice pair ou Impair. 



Attention 

La fonction 11 st ( ) ne s'applique pas aux tableaux associatifs, desquels elle ne récupère ni clés ni valeurs. 
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f*' Exemple 5-1 1 . Lecture avec list() et each() 

<?php 

//listO avec un tableau indicé 
$tab=array( "Paris" , "London" , "Brûssel " ) ; 
list($x.$y) = $tab: 

echo "Les deux premiers éléments sont : $x et $y <hr />"; 

//listO avec un tableau associatif (ne fonctionne pas) 

$tab=array( "France" =>" Pari s" , "Great Bri tain "=>" London" , "Bel gië"=>"Brussel " ) ; 

list($x.$y) = $tab; 

echo "Les deux premiers éléments sont : $x et $y <hr />"; 
/ 

//Lecture de tableau indicé 

$tab=array("Paris" , "London" , "Brûssel ") ; 
while(list($indice,$valeur) = each($tab) ) 
{ 

echo "L'élément d'indice <b>$indice</b> a la valeur <b>$val eur</b><br>" ; 

} 

echo"<hr />"; 

/ /-k-k-k-krk-k-h-k-k-k-k-k-k-h-k-k-k-k-k-k^-h-k-k-k-k-k-k-k 

//Lecture de tableau associatif 

/ f-k-k-h-k-k-k-h-k-k-k-k-k-k-h-k-k-^-k-k-k-k-k-k-k-^-k-k-k-k 

$tab=array("France"=>"Paris" , "Great Bri tain"=>" London" , 
^"België"=>"Brûssel ") ; 
while{list($cle,$valeur) = each($tab) ) 
{ 

echo "L'élément de clé <b>$cle</b> a la valeur <b>$val eur</b><br />"; 
} 

?> 

La lecture des tableaux affiche les résultats suivants : 



Les deux premiers éléments sont : Paris et London 

Notice: Undefined offset: 1 in c:\eyrolles\php5\tableaux\tableaull.php on line 8 

Notice: Undefined offset: 0 in c:\eyrolles\php5\tableaux\tableaull.php on line 8 
Les deux premiers éléments sont : et 
L'élément d'indice 0 a la valeur Paris 
L'élément d'indice 1 a la valeur London 
L'élément d'indice 2 a la valeur Brûssel 

L'élément de clé France a la valeur Paris 
L'élément de clé Great Britain a la valeur London 
L'élément de clé België a la valeur Brûssel 



Remarquez l'avis d'erreur si vous utilisez la fonction 1 i st ( ) seule pour un tableau asso- 
ciatif. 
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Linstruction foreach 

Plus pratique encore que les méthodes précédentes, l'instruction foreachO n'est utilisa- 
ble qu'à partir des versions 4 de PHP. Elle se révèle particulièrement efficace pour les 
tableaux associatifs mais fonctionne également pour les tableaux indicés. 

Contrairement à la boucle for, l'instruction foreachO ne nécessite pas de connaître par 
avance le nombre d'éléments du tableau à lire. Sa syntaxe varie en fonction du type de 
tableau. 

Pour les tableaux indicés, vous écrivez le code suivant : 

foreach($tab as Svaleur) 
{ 

//bloc de code utilisant les valeurs de la variable Svaleur; 
} 

Indispensable, le mot-clé as permet de récupérer successivement toutes les valeurs des 
éléments du tableau $tab dans la variable $val eur, mais sans les indices correspondants. 

Pour les tableaux associatifs, vous disposez d'une syntaxe plus perfectionnée. 

Le code suivant : 

foreach($tab as $cl e=>$val eur) 
{ 

//bloc de code utilisant les valeurs des variables $cle et Svaleur; 
} 

permet de récupérer dans la variable $cl e les valeurs et les clés successives des éléments. 
De plus, si le tableau est indicé numériquement, la variable $cl e contient cet indice. 

Si vous disposez d'un serveur équipé des versions 4 et suivantes de PHP, ces méthodes 
de lecture sont particulièrement recommandées du fait de leur simplicité d'écriture et de 
leur rapidité d'exécution. 

Vous allez maintenant envisager un ensemble d'exemples d'utilisation de l'instruction 
foreach appliquée à la lecture de tableaux de formes diverses. 

Lecture de tableaux indicés ou associatifs 

Le listing 5-12 effectue une lecture de tableaux indicés et associatifs à l'aide de l'instruc- 
tion foreach avec et sans récupération des indices ou clés des éléments. Le résultat est 
similaire à celui obtenu avec les fonctions 1 i st( ) et each( ) de la section précédente, mais 
le code est plus élégant. 

Exemple 5-12. Lecture de tableaux à l'aide de l'instruction foreach 

<?php 

//Lecture de tableau indicé sans récupération des indices 

$tab=array( "Paris" , "London" , "Briissel " ) ; 

echo "<H3>Lecture des valeurs des éléments </H3>"; 
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foreach($tab as $ville) 
{ 

echo "<b>$vine</b> <br>": 

} 

echo"<hr>" ; 

//Lecture de tableau indicé avec récupération des indices 

echo "<h3>lecture des indices et des valeurs des éléments </h3>": 

foreach($tab as $indice=>$ville) 

{ 

echo "L'élément d'indice <b>$indice</b> a la valeur <b>$ville</b><br>"; 

} 

echo"<hr>" ; 

//Lecture de tableau associatif avec récupération des clés 

$tab2=array( "France" =>" Pari s" , "Great Bri tain"=>"London" , "Bel gië"=>"Brûssel " ) ; 
echo "<h3>lecture des clés et des valeurs des éléments</h3>" ; 
foreach($tab2 as $cl e=>$vi 1 1 e) 
{ 

echo "L'élément de clé <b>$cle</b> a la valeur <b>$vi 1 1 e</b> <br>"; 
} 

echo"<hr>" ; 
?> 

Lecture d'un tableau multidimensionnel 

L'exemple 5-13 illustre la lecture du tableau multidimensionnel et associatif $clients 
répertoriant un ensemble de clients dont chaque élément de premier niveau est lui-même 
un tableau associatif contenant les caractéristiques de chaque client. 

Ce tableau multidimensionnel contient deux boucles foreach imbriquées. La première 
récupère la clé de chacun des éléments du tableau $clients dans la variable $cle et son 
contenu de type array dans la variable $tab. La seconde boucle lit chaque tableau $tab en 
récupérant chaque clé contenue dans la variable $ key et la valeur de chaque élément dans 
la variable $val eur. L'affichage se fait dans un tableau XHTML. 

La figure 5-4 donne un aperçu du résultat affiché par ce script. 

Exemple 5-13. Lecture de tableaux multidimensionnels avec foreachQ 

<!DOCTYPE html PUBLIC ''-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Lecture d'un Tableau multidimensionnel avec foreachC )</title> 

</head> 

<body> 

<div> 
<?php 



124 



PHP 5 



lie l"=>"Paris","age 1"=>"35"), 
le 2"=>"Vincennes","age 2"=>"22"), 
lie 3"=>"St Cloud","age 3"=>"47")); 



//Création du tableau 
$clients = array( 

"client l"=>array( "nom r'=>"Leparc" , "vi 
"client 2"=>array( "nom 2"=>"Duroc" , "vi 1 
"client 3"=>array( "nom 3"=>"Denoël " , "vi 
//Ajout d'un élément 

$clients["client 7"] = array("nom 7"=>"Duval " , "vi 1 1 e 7"=>"Marseil 1 e" , "âge 7"=>"76"); 
echo "<table border=\"l\" width=\"100%\" ><thead><tr> <th> Client </th><th> Nom </th> 
*<th> Ville </th><th> Age </th></tr></thead><tbody>" ; 
foreach($cl ients as $cle=>$tab) 
{ 

echo "<tr><td al ign=\"center\"><b> $cle </b></td>": 

foreach($tab as $key=>$val eur) 

{ 

echo "<td> $key : <b> $valeur </b></td>"; 

) 

echo "</tr>"; 

} 

?> 

</tbody> </table> 
</div> 

<P> 
<a bref 



http: //val idator.w3.org/check?uri=referer"><img 
src="http: //www. w3.org/Icons /val id-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 



</p> 
</body> 
</html> 
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Figure 5-4 

Lecture d'un tableau multidimensionnel associatif avec foreach() 



Manipuler des tableaux 

PHP dispose d'un grand nombre de fonctions permettant d'effectuer toutes sortes de 
manipulations de tableaux existants. Citons notamment l'extraction, l'ajout ou la 
suppression d'une partie des éléments, la fusion ou l'intersection de plusieurs tableaux, 
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diverses opérations de tri des éléments ou des clés ou encore l'application d'une fonction 
à l'ensemble des éléments. 



Extraire une partie d'un tableau 

A partir d'un tableau donné, il est possible de créer un nouveau tableau comme sous- 
ensemble du tableau initial et ne contenant qu'un nombre déterminé de ses éléments. 
Cette opération est réalisée à l'aide de la fonction array„sl i ce( ), qui permet d'effectuer 
divers types d'extractions. 

La syntaxe de la fonction array„sl i ce( ) est la suivante : 
I $sous_tab = array_sl ice(array $tab.int ind, int nb) 

Cette fonction ne modifie pas le tableau initial mais retourne le sous-tableau dans la 
variable $sous_tab. Sa manipulation pouvant se révéler relativement complexe en fonc- 
tion des valeurs des paramètres ind et nb, nous envisageons ci-après tous les cas possibles : 

• Si ind et nb sont positifs, le tableau $sous_tab contient nb éléments du tableau initial 
extrait en commençant à l'indice ind. 

Par exemple, array_sl ice($tab,2,3) retourne un tableau comprenant trois éléments 
extraits à partir de l'indice 2. Il contient donc les éléments d'indice 2, 3 et 4 du tableau 
$tab. 

• Si le paramètre ind est négatif et que nb est positif, le compte des éléments se fait en 
partant de la fin du tableau $tab, le dernier se trouvant affecté virtuellement de l'indice 
-1, r avant-dernier de l'indice -2, et ainsi de suite. Le paramètre nb désigne encore le 
nombre d'élément à extraire. 

Par exemple, array_sl ice($tab,-5,4) retourne quatre éléments de $tab extraits en 
commençant au cinquième à partir de la fin. 

• Si ind est positif et nb négatif, le tableau $sous„tab contient les éléments de $tab 
extraits en commençant à l'indice ind et en s'arrêtant à celui qui a l'indice négatif 
virtuel nb (toujours en commençant par la fin). 

Par exemple, array_slice($tab,2,-4) retourne tous les éléments à partir de l'indice 2 
jusqu'à la fin, sauf les quatre derniers. 

• Si ind et nb sont négatifs, le tableau $sous_tab contient les éléments de $tab extraits en 
commençant à l'indice négatif ind et en s'arrêtant à celui d'indice négatif nb. 

Par exemple, array_sl ice($tab,-5,-2) retourne trois éléments compris entre les indi- 
ces virtuels -5 compris et -2 non compris. 

La mise en pratique de l'exemple 5-14 donne deux types d'utilisation de la fonction 
array_sl i ce( ). Le premier n'utilise que des paramètres positifs et s'applique à un tableau 
multidimensionnel dont les éléments sont des tableaux indicés ou associatifs. Le second 
envisage toutes les possibilités de valeurs pour les paramètres ind et nb en les appliquant 
à un tableau simple. 
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'•^ Exemple 5-14. Utilisation de la fonction array_slice() 

<?php 

echo"Exempl e Kbr />" ; 

$tab= array("UN"=>range(1.5),"DEUX"=>range("a","c"),range("A","E"),range(11.15)); 
echo "Structure du tableau initial :<br />"; 
print_r($tab) ; 
echo "<hr />"; 

$soustab = array_sl ice($tab,l ,2) : 
echo"array_slice(\$tab,l,2) donne : 
print_r($soustab) ; 
echo "<hr />"; 
echo"Exemple 2<br>"; 

$heros= array( "Spock" , "Batman" , "Dark Vador" , "Hal " , "Frodo" , "Sky Walker","Amidala", 
^"Alien"): 

echo "Structure du tableau initial :<br>"; 

print_r($heros) ; 

echo "<hr />"; 

//Extrait des 5 premiers 

echo "array_slice(\$heros,0,5)" ; 

$preni=array_slice($heros,0,5) ; 

print_r($prein) ; 

echo "<hr />"; 

//Extrait des 5 derniers (le dernier est considéré comme ayant l'indice -1 et non 
^ pas 0) 

$der=array_slice($heros,-5,5) ; 
echo"array_sl i ce (\$ héros, -5, 5) " ; 
print_r($der) ; 
echo "<hr />"; 

//Extrait de 3 noms en commençant à la position -5 
$der=array_sl i ce ($ héros ,-5,3) ; 
echo"array_sl ice(\$heros,-5,3) " ; 
print_r($der) ; 
echo "<hr />"; 

//Extrait des éléments de l'indice 1 jusqu'à la fin hormis les deux derniers 
$der=array_sl ice($heros ,1,-2); 
echo"array_sl ice(\$heros,l,-2) " ; 
print_r($der) ; 
echo "<hr />"; 

//Extrait des éléments de l'indice -5 jusqu'à la fin hormis les deux derniers 

$der=array_slice($heros,-5,-2) ; 

echo"array_sl ice(\$heros,-5,-2) " ; 

print_r($der) ; 

echo "<hr />"; 

?> 
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Le listing de l'exemple 5-14 affiche le résultat suivant : 



Exemple 1 

Structure du tableau initial : 

Array ( [UN] => Array ( [0] => 1 [1] => 2 [2] 3 [3] => 4 [4] => 5 ) [DEUX] => 
Array ( [0] => a [1] => b [2] c ) [0] Array ( [0] => A [1] => B [2] C [3] 
D [4] => E ) [1] => Array ( [0] => 11 [1] 12 [2] => 13 [3] => 14 [4] => 15 ) ) 

array_slice($tab.l,2) donne : Array ( [DEUX] Array ( [0] => a [1] => b [2] => c ) 
[0] Array ( [0] => A [1] => B [2] => C [3] D [4] => E ) ) 

Exemple 2 

Structure du tableau initial : 

Array ( [0] Spock [1] => Batman [2] Dark Vador [3] => Hal [4] => Frodo [5] 
Sky Walker [6] Amidala [7] Alien ) 

array_slice($heros,0,5)Array ( [0] Spock [1] => Batman [2] Dark Vador [3] 
Hal [4] => Frodo ) 

array_slice($heros,-5.5) Array ( [0] => Hal [1] => Frodo [2] => Sky Walker [3] => 
Amidala [4] Alien ) 

array_slice($heros,-5,3) Array ( [0] => Hal [1] => Frodo [2] Sky Walker ) 

array_slice($heros,l.-2) Array ( [0] => Batman [1] => Dark Vador [2] => Hal [3] => 
Frodo [4] => Sky Walker ) 

array_slice($heros,-5.-2) Array ( [0] => Hal [1] Frodo [2] Sky Walker ) 



Ajouter et enlever des éléments 

Une fois un tableau créé à l'aide de la fonction array( ) et certaines valeurs affectées à ses 
éléments, vous pouvez effectuer diverses manipulations d'ajout ou de retrait d'éléments 
selon les besoins. 

La fonction : 

I int array_push($tab, valeurl, valeur2 valeurN) 

ajoute en une seule opération les N éléments passés en paramètres à la fin du tableau 
désigné par la variable $tab. Vous pouvez évidemment remplacer les valeurs passées en 
paramètres par des variables. 

Les nouveaux indices ainsi créés ont pour valeur celle du plus grand indice existant (donc 
égal à count($tab)-l ) incrémenté de 1 jusqu'à N. La fonction retourne également le 
nouveau nombre d'éléments du tableau modifié. 

Pour ajouter des éléments au début d'un tableau, vous pouvez utiliser la fonction suivante : 
I int array_unshift($tab, valeurl, valeur2 valeurN) 
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Cette fonction ajoute également au tableau $tab les éléments passés en paramètres 
mais cette fois au début du tableau. Les indices existants sont tous décalés de la valeur A'^, 
et la fonction retourne le nouveau nombre d'éléments du tableau. 

Réciproquement, vous pouvez supprimer des éléments d'un tableau à l'aide de la fonc- 
tion suivante : 

I array_pop($tab) 

qui supprime le dernier élément du tableau $tab et retourne cet élément s'il existe ou la 
valeur NULL dans le cas contraire, par exemple si le tableau est vide ou si le paramètre 
$tab n'est pas de type array. Avec les fonctions array_push() et array_pop(), le tableau 
se comporte comme une pile dotée respectivement de fonctions d'empilement et de 
dépilement. 

Dans ce cas, un avertissement du type : 

IWarning: array_pop(): The argument should be an array in c:\eyrolles\php5\tableaux\ 
^tableaulB.php on line 18 

est affiché, ce qui n'est pas du meilleur effet sur les utilisateurs. Dans le doute, il est 
préférable d'utiliser la fonction gettype( ) pour s'assurer que le paramètre $tab est bien de 
type array. 

Pour supprimer le premier élément d'un tableau, utilisez la fonction suivante : 
I array_shift($tab) 

qui retourne la valeur de l'élément supprimé. 

Enfin, il est possible de supprimer un élément d'indice ou de clé quelconque du tableau 
$tab à l'aide de la fonction unsetC ) en précisant explicitement le nom de l'élément et son 
indice ou sa clé. 

Par exemple : 

I unset($tab[4]) 

supprime l'élément d'indice 4 du tableau $tab et 
[ unset($tab["quatre"]) 
l'élément dont la clé est "quatre". 

Cette fonction n'a pas d'effet sur les autres indices du tableau, qui conservent tous la 
valeur qu'ils avaient avant la suppression. 

L'exemple 5-15 illustre toutes ces fonctions de modification des tableaux et affiche la 
structure du tableau après chacune d'elles. 

c Exemple 5-1 5. Ajout et suppression d'éléments 

<?php 

$tab= array(800,1492. 1515, 1789); 
print_r($tab) ; 
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echo "<hr />"; 

//Ajout au début du tableau 

$poitiers=732: 

$nb=array_unshift($tab, 500. $poi tiers) ; 

echo "Le tableau \$tab a maintenant $nb éléments <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Ajout à la fin du tableau 

$armi=1918: 

$newnb=array_push($tab, 1870, 1914, $armi ) ; 

echo "Le tableau \$tab a maintenant $newnb éléments <br>"; 

print_r($tab) ; 

echo "<hr />"; 

//Suppression du dernier élément 
$suppr= array_pop($tab) ; 

echo "Le tableau \$tab a perdu l'élément $suppr <br>"; 
print_r($tab) ; 
echo "<hr />"; 

//Suppression du premier élément 
$suppr= array_shift($tab) ; 

echo "Le tableau \$tab a perdu l'élément $suppr <br>"; 
print_r($tab) ; 
echo "<hr />"; 

//Suppression de l'élément d'indice 4 

unset($tab[4]): 

print_r($tab) ; 

?> 

Le résultat du listing de l'exemple 5-15 permet de suivre l'évolution du tableau initial au 
fur et à mesure des modifications opérées : 



Array ( [0] 800 [1] 1492 [2] 1515 [3] => 1789 ) 
Le tableau $tab a maintenant 6 éléments 

Array ( [0] 500 [1] 732 [2] => 800 [3] => 1492 [4] => 1515 [5] => 1789 ) 
Le tableau $tab a maintenant 9 éléments 

Array ( [0] 500 [1] 732 [2] => 800 [3] => 1492 [4] => 1515 [5] 1789 [6] 

1870 [7] => 1914 [8] => 1918 ) 

Le tableau $tab a perdu l'élément 1918 

Array ( [0] 500 [1] 732 [2] => 800 [3] => 1492 [4] => 1515 [5] => 1789 [6] 
1870 [7] => 1914 ) 

Le tableau $tab a perdu l'élément 500 

Array ( [0] => 732 [1] => 800 [2] => 1492 [3] 1515 [4] 1789 [5] => 1870 [6] => 
1914 ) 

L'élément d'indice 4 a été supprimé 

Array ( [0] 732 [1] 800 [2] => 1492 [3] 1515 [5] 1870 [6] => 1914 ) 



Suite à une recherche dans une base de données à l'aide de critères multiples, un tableau 
peut être amené à contenir plusieurs fois les mêmes valeurs pour certains critères. Avant 
de traiter les données du tableau, il peut être préférable en ce cas d'éliminer les éléments 
faisant double emploi. 
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La fonction array_um que($tab) retourne un nouveau tableau ne contenant que la dernière 
occurrence de chaque valeur présente plusieurs fois dans le tableau $tab. Les indices ou 
les clés associés à chaque élément sont conservés, et le tableau retourné comporte des 
« trous » dans la suite des indices si ces derniers sont numériques. 

Par exemple, le code suivant : 

<?php 

$tab = a rrayC Jacques" , "Paul ", "Pierre" , "Al ban" , "Paul ", "Jack" , "Paul" ) ; 

$tab2 = array_unique($tab) : 

print_r($tab2): 

?> 

supprime les éléments d'indices 1 et 4 qui ont la valeur "Paul" pour ne conserver que 
l'élément d'indice 6. Vous obtenez l'affichage suivant de la structure du tableau résultant 
$tab2 : 



Array ( [0] => Jacques [2] => Pierre [3] => Alban [5] => Jack [6] => Paul ) 



Opérations sur plusieurs tableaux 

Il est possible d'effectuer différents types d'opérations faisant intervenir plusieurs 
tableaux, qu'il s'agisse de les fusionner ou d'effectuer des opérations ensemblistes, 
comme leur intersection ou leur différence. 

Fusionner des tableaux 

Si des données figurent dans plusieurs tableaux différents, vous pouvez être amené à 
vouloir effectuer des opérations sur ces différents tableaux afin d'obtenir un tableau 
unique contenant soit la réunion des éléments de chacun en un seul, soit les éléments 
communs aux deux, soit encore les éléments présents dans l'un et pas dans l'autre. 

Vous pouvez, par exemple, réunir deux ou plusieurs tableaux en un seul à l'aide de la 
fonction array„merge( ), dont la syntaxe est la suivante : 

[ $tab = array_merge($tabl,$tab2 $tabN) 

Cette fonction retourne dans $tab l'ensemble des éléments présents dans les tableaux 
$tabl, $tab2, $tabN. Les tableaux passés en paramètres sont tous sauvegardés tels 
qu'ils étaient avant l'appel de la fonction. 

La fusion des tableaux est réalisée dans les conditions suivantes : 

• Si les tableaux à fusionner sont indicés, les éléments du tableau passé en premier 
paramètre sont conservés, ceux des autres paramètres ayant les indices suivants. Les 
éléments présents dans plusieurs des paramètres sont présents en double dans le 
tableau final. Vous pouvez utiliser la fonction array_unique( ) pour les éliminer. 



Les tableaux 

Chapitre 5 



• Si les tableaux à fusionner sont associatifs, les clés et les associations clé-valeur sont 
préservées. Par contre, si plusieurs des paramètres ont des clés communes, seule 
l'association clé -valeur du dernier paramètre est conservée, et celle du tableau précé- 
dent est perdue. 

Pour ne pas perdre les informations correspondant à une même clé, il est possible d'utiliser 
la fonction array_merge_recursive( ). Cette dernière n'efface pas la première valeur asso- 
ciée à une clé double mais associe à chaque clé présente plusieurs fois un tableau indicé 
contenant toutes les valeurs ayant la même clé. 

Le listing de l'exemple 5-16 donne deux exemples de fusion de tableaux, le premier pour 
les tableaux indicés et le second pour les tableaux associatifs. Remarquez la disparition 
de la valeur "75" associée à la clé "Paris" du tableau $tabassl, remplacée par la valeur 
"Capitale" présente dans le tableau $tabass2 après la fusion effectuée avec array_merge( ). 
La fonction array_merge_recursive( ) préserve les deux valeurs, comme le montre le 
résultat du script. 

Exemple 5-16. Fusion de tableaux à l'aide de array_merge() 

<?php 

//Fusion de tableaux indicés 

echo "Tableaux indicés <br>": 

$tabl= array( "Paris" , "Lyon" , "Marsei lie"); 

$tab2 = arrayC "Nantes" , "Orl éans" , "Tours" , "Pari s" ) : 

$tab = array_inerge($tabl,$tab2); 

echo "arrayjerge donne: "; 

print_r($tab) ; 

echo "<hr />"; 

//Fusion de tableaux associatifs 
echo "Tableaux associatifs <br>"; 

$tabassl= array("Paris" "75", "Lyon" => "69", "Marseille" => "13"); 
$tabass2 = arrayC "Nantes" => "44" , "Orl éans" => "45", "Tours" "37", "Paris" 
^"Capitale") ; 

echo "array_merge donne: "; 

Stabass = array_merge($tabassl,$tabass2) ; 

print_r($tabass) ; 

echo "<hr />"; 

//Fusion 

echo "array_irerge_recursive donne : "; 

$tabass3 = array_inerge_recursive($tabassl,$tabass2) ; 

print_r($tabass3) ; 

?> 

Le script affiche le résultat suivant, qui montre la structure des tableaux résultant de la 
fusion : 



Tableaux indicés 

array_merge donne: Array ( [0] Paris [1] => Lyon [2] => Marseille [3] Nantes [4] 
Orléans [5] Tours [6] => Paris ) 
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Tableaux associatifs 

array_itierge donne: Array ( [Paris] => Capitale [Lyon] => 69 [Marseille] => 13 [Nantes] 
=> 44 [Orléans] => 45 [Tours] => 37 ) 

array_merge_recursive donne : Array ( [Paris] => Array ( [0] => 75 [1] => Capitale) 
[Lyon] 69 [Marseille] => 13 [Nantes] => 44 [Orléans] => 45 [Tours] => 37 ) 



Vous pouvez également créer un tableau associatif à partir de deux autres tableaux. Le 
premier contient les clés du tableau à créer et le second les valeurs qui sont associées aux 
clés. Cette opération est réalisable grâce à la fonction array_combine( ) introduite dans 
PHP 5. Sa syntaxe est la suivante : 

I array array_combine(array Stabcle, array Stabval ) 

Le code suivant : 

$tabcle = array( 'F'.'D'.'B'); 
$tabval = array( ' France' , 'Al lemagne' ,' Belgique' ) ; 
$tabasso = array_combine($tabcle, Stabval); 
print_r($tabasso) ; 

affiche le résultat : 



Array ( [F] => France [D] Allemagne [B] => Belgique ) 



Intersection et différence de deux tableaux 

Quelques souvenirs de manipulation des ensembles devraient vous permettre de mieux 
saisir l'utilité des fonctions permettant d'obtenir soit l'intersection de deux tableaux 
considérés comme des ensembles de valeurs, soit leur différence. 

L'intersection de deux ensembles est constituée par les éléments qui appartiennent à la 
fois aux deux ensembles. La différence de deux ensembles désigne les éléments qui 
appartiennent au premier et pas au second. En d'autres termes, sont enlevés du premier 
tableau les éléments qui appartiennent aussi au second. 

PHP offre deux fonctions pour réaliser ces opérations sur des tableaux, array_ 
intersect( ) et array_diff ( ). 

Pour l'intersection de deux tableaux, la syntaxe de array_intersect( ) est la suivante : 
I array array_intersect($tabl,$tab2) 

Cette fonction retourne un tableau contenant tous les éléments communs aux tableaux 
$tabl et $tab2. Les indices associés aux valeurs du tableau retourné comme résultat 
correspondent à ceux du tableau passé en premier paramètre. L'inversion de ces deux 
paramètres ne fournit pas les mêmes indices (voir le résultat du listing de l'exemple 5-17 
ci-après). 

Pour la différence de deux tableaux, la syntaxe de la fonction array_di f f ( ) est la suivante : 
I array_diff ($tabl,$tab2) 
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Elle retourne un tableau contenant les éléments présents dans le premier paramètre mais 
pas dans le second. Comme pour la soustraction de nombres, il est logique que l'inver- 
sion des paramètres ne fournisse pas le même résultat. Les indices associés aux valeurs 
dans les tableaux d'origine sont conservés. 

Si vous appliquez ces deux fonctions à des tableaux associatifs, les clés sont conservées 
dans les mêmes conditions. De plus, si nos exemples ne montrent que l'intersection de 
deux tableaux, il est parfaitement licite de passer à ces fonctions un nombre quelconque 
de paramètres, du moment qu'il s'agit bien de variables de type array. 

Exemple 5-17. Intersection et différence de deux tableaux 

<?php 

$tabl=array( "Bl anc" , "Jaune" , "Rouge" , "Vert" , "Bl eu" . "Noi r" ) ; 
$tab2=array( "Bl eu" , "Rouge" , "Viol et" , "Noi r" , "Jaune" , "Orange" ) ; 
echo"Le tableau 1 contient les éléiïients:<br />"; 
print_r($tabl) ; 
echo "<hr />"; 

echo"Le tableau 2 contient les éléments:<br />"; 
print_r($tab2) ; 
echo "<hr />"; 

echo "Intersection de \$tabl et \$tab2 : "; 
$tab3=array_intersect($tabl , $tab2) ; 
print_r($tab3) ; 
echo"<br />"; 

echo "Intersection de \$tab2 et \$tabl : "; 
$tab4= array_intersect($tab2,$tabl) ; 
print_r($tab4) ; 
echo"<hr />"; 

$tab5= array_diff($tabl,$tab2) : 

echo "Différence de \$tabl et \$tab2 : "; 

print_r($tab5) ; 

echo"<br />"; 

$tab6= array_diff($tab2,$tabl): 

echo "Différence de \$tab2 et \$tabl : "; 

print_r($tab6) ; 

echo"<br />"; 

?> 

Le script affiche les résultats suivants, qui montrent bien l'importance de l'ordre des 
paramètres. 



Le tableau 1 contient les éléments: 

Array ( [0] Blanc [1] => Jaune [2] => Rouge [3] => Vert [4] => Bleu [5] => Noir ) 
Le tableau 2 contient les éléments: 

Array ( [0] => Bleu [1] => Rouge [2] => Violet [3] => Noir [4] => Jaune [5] => Orange ) 
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Intersection de $tabl et $tab2 : Array ( [1] Jaune [2] => Rouge [4] Bleu [5] => 
Noir ) 

Intersection de $tab2 et $tabl : Array ( [0] Bleu [1] Rouge [3] => Noir [4] => 
Jaune ) 

Différence de $tabl et $tab2 : Array ( [0] => Blanc [3] => Vert ) 
Différence de $tab2 et $tabl : Array ( [2] => Violet [5] Orange ) 



Trier les éléments d'un tableau 

Quand une fonction retourne un tableau de valeurs, comme le font, par exemple, les 
fonctions de recherche sur une base de données MySQL, les valeurs des éléments appa- 
raissent dans un ordre qui n'est pas nécessairement celui souhaité pour l'affichage des 
informations. 

Pour améliorer la présentation des données, il est souvent utile d'effectuer un tri des 
valeurs contenues dans le tableau avant de les utiliser pour créer un affichage dans une 
page Web. PHP fournit nombre de fonctions natives permettant de réaliser les opérations 
de tri les plus diverses. Ces opérations peuvent concerner les valeurs comme les clés des 
éléments de tableau, aussi bien en ordre alphabétique ASCII, direct ou inversé, que selon 
l'ordre dit « naturel » ou encore d'après des critères personnalisés définis par le program- 
meur lui-même. 

La quasi-totalité de ces fonctions agit directement sur le tableau qui leur est passé en 
paramètre en modifiant l'ordre de ses éléments ou de ses clés. Le tableau initial n'est pas 
récupérable. C'est pour cette raison que les exemples qui suivent créent dès le début du 
script une copie du tableau initial qui est réutilisée pour chaque fonction. 

Certaines fonctions sont plus appropriées à des tableaux indicés et d'autres à des tableaux 
associatifs. La présentation de ces fonctions est donc divisée en plusieurs sections. 

Trier des tableaux indicés 

Les fonctions natives offertes par PHP permettent les opérations de tri des éléments des 
tableaux selon les critères les plus variés. 

Trier selon l'ordre ASCII 

L'ordre ASCII n'a rien d'évident pour qui est habitué à l'ordre lexicographique, qui est 
celui du dictionnaire. Dans untriASCII, "rouge" se trouve après "Vert" car la lettre "r" se 
trouve après la lettre "V" . 

Les fonctions de tri dans l'ordre ASCII proposées par PHP sont les suivantes : 

• array sort($tab). Trie les valeurs du tableau $tab en ordre croissant des codes ASCII 
des caractères qui les composent (donc en tenant compte de la casse des caractères). 
Les correspondances entre les indices et les valeurs des éléments sont perdues après 
le tri. 
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• array rsort($tab). Trie les valeurs du tableau $tab en ordre décroissant des codes 
ASCII des caractères qui les composent. Les correspondances entre les indices et les 
valeurs des éléments sont perdues après le tri. 

• array array_reverse($tab). Inverse l'ordre des valeurs des éléments de $tab. Les indi- 
ces sont évidemment perdus. 

L'exemple 5-18 illustre l'emploi de ces fonctions et affiche le tableau initial puis le 
tableau une fois trié. 

Exemple 5-18. Tri selon l'ordre ASCII 

<?php 

/ /-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//TABLEAU INDICE 
/ 

//Définition du tableau 

$tabind=array( "Bl anc2" , "Jaune" , "rouge" , "Vert" , "Bleu" , "Noi r" , "Bl anclO" ) ; 
$copie= $tabind; 

echo "<b>Tableau indicé d'origine</b><br />"; 
print_r($tabind) ; 
//Fonction sortO 

echo "<hr />Tri en ordre ASCII sans sauvegarde des indices<br />"; 

$tabind=$copie; 

sort($tabind) ; 

print_r($tabind) ; 

//Fonction rsortO 

echo "<hr /> Tri en ordre ASCII inverse sans sauvegarde des indices<br />"; 

$tabind=$copie; 

rsort($tabind) ; 

print_r($tabind) ; 

//Fonction array_reverse( ) 

echo "<hr />Inversion de l'ordre des éléments<br />"; 
$tabind=$copie; 

$tabrev=array_reverse($tabind) ; 

print_r($tabrev) ; 

?> 

Le script donne les résultats suivants : 



Tableau indicé d'origine 

Array ( [0] => Blanc2 [1] => Jaune [2] => rouge [3] => Vert [4] => Bleu [5] => Noir [6] 
BlanclO ) 

Tri en ordre ASCII sans sauvegarde des indices 

Array ( [0] BlanclO [1] Blanc2 [2] => Bleu [3] Jaune [4] Noir [5] => Vert 
[6] rouge ) 

Tri en ordre ASCII inverse sans sauvegarde des indices 

Array ( [0] => rouge [1] => Vert [2] => Noir [3] => Jaune [4] => Bleu [5] => Blanc2 [6] 
BlanclO ) 
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Inversion de l'ordre des éléments 

Array ( [0] => BlanclO [1] => Noir [2] => Bleu [3] => Vert [4] => rouge [5] => Jaune 
[6] => Blanc2 ) 



Trier selon l'ordre naturel 

L'ordre dit naturel est plus proche de ce que chacun connaît dans la vie courante. Par 
exemple, pour un tri en ordre croissant, la chaîne "BlanclO" se trouve après "Blanc2" et 
"IZZ" avant "2AA", les chiffres étant considérés comme précédant les lettres. 

Il existe deux variantes de fonctions de tri selon l'ordre naturel, suivant qu'il est tenu 
compte ou non de la casse des caractères : 

• array natsort($tab). Trie les valeurs du tableau $tab selon l'ordre naturel croissant des 
caractères qui les composent. Le tri étant effectué en tenant compte de la casse, les 
majuscules sont placées avant les minuscules, par exemple "Vert" avant "rouge". Les 
correspondances entre les indices ou les clés et les valeurs des éléments sont sauvegar- 
dées après le tri, ce qui rend la fonction également applicable aux tableaux associatifs. 

• array natcasesort{$tab). Trie les valeurs du tableau $tab selon l'ordre naturel crois- 
sant, sans tenir compte de la casse, ce qui correspond davantage à l'ordre courant du 
dictionnaire, dans lequel "rouge" se trouve avant "Vert". Les correspondances entre 
les indices ou les clés et les valeurs des éléments sont sauvegardées après le tri. 



for ou foreach ? 

Du fait que les fonctions array natsortO et array natcasesort( ) conservent les correspondances 
entre les indices ou les clés et les valeurs, il est déconseillé d'utiliser une boucle for pour lire l'ensemble 
des données, au risque de perdre l'ordre créé par le tri. Une boucle foreach est indispensable, même 
pour des tableaux indicés. 



t*" Exemple 5-1 9. Tri selon l'ordre naturel 

<?php 

//TABLEAU INDICE 

/ /-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//Définition du tableau 

$tabind=array( "Bl anc2" , "Jaune" , "rouge" , "Vert" , "Bl eu" , "Noi r" , "Bl anclO" ,"111" . "2AA" ) ; 
$copie= $tabind: 

echo "<b>Tableau indicé d'origine</b><br />"; 
print_r($tabind) ; 

^kk-kkkkk-kkkkkkk-kkk-kkkk-k-kkk-kkkkk-kk 

echo "<hr />Tri en ordre naturel avec sauvegarde des indices<br />"; 
$tabind=$copie; 
natsort($tabind) ; 
print_r($tabind) ; 
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I j-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

echo "<hr />Tri en ordre naturel insensible à la casse avec sauvegarde des indices 

^<br />": 

$tabind=$copie; 

natcasesort($tabind) ; 

print_r($tabind) : 

foreach ($tabind as $cle=>$val) 

{ 

echo "$cle => $val <br />"; 
} 

?> 

Les résultats des tris sont les suivants : 



Tableau indicé d'origine 

Array ( [0] => Blanc2 [1] => Jaune [2] => rouge [3] => Vert [4] => Bleu [5] => Noir [6] 
BlanclO [7] IZZ [8] => 2AA ) 

Tri en ordre naturel avec sauvegarde des indices 

Array ( [7] => IZZ [8] => 2AA [0] => Blanc2 [6] BlanclO [4] => Bleu [1] => Jaune [5] 
Noir [3] Vert [2] => rouge ) 

Tri en ordre naturel insensible à la casse avec sauvegarde des indices 
Array ( [7] => IZZ [8] => 2AA [0] Blanc2 [6] BlanclO [4] => Bleu [1] Jaune [5] 
Noir [2] rouge [3] => Vert ) 



Trier selon un critère personnel 

Si les fonctions de tri précédentes ne nous conviennent pas, vous pouvez définir vous- 
même un critère de tri. Il vous suffit pour cela de créer une fonction de comparaison. 
Cette dernière effectue un test contenant un opérateur impliquant une relation d'ordre sur 
les valeurs des éléments. 



Pour en savoir plus 

Pour savoir comment définir une fonction personnalisée, reportez-vous au chapitre 7. 



La fonction doit retourner une valeur entière positive, négative ou nulle selon le résultat 
du test. Vous choisirez généralement les valeurs 1, -1 et 0, mais vous pourriez tout aussi 
bien choisir A^, -A' et 0). Le tri s'effectue dans les conditions suivantes : 

• Si le test est évalué à TRUE et que la fonction retourne un nombre négatif, les éléments 
sont triés dans l'ordre défini par le critère du test. 

• Si le test est évalué à TRUE et que la fonction retourne un nombre positif, les éléments 
sont triés dans l'ordre inverse de celui défini par le critère du test. 

• Si le test est évalué à TRUE et que la fonction retourne 0, les éléments sont de même 
rang dans l'ordre du test. 
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Dans l'exemple 5-20, la fonction de test 1 ong( ), dont le code figure ci-dessous, compare 
la longueur des chaînes de caractères à l'aide de la fonction strlen( ). Si la chaîne conte- 
nue dans $motl est plus longue que celle contenue dans $mot2, la fonction retourne -1, et 
$motl est placé avant $mot2. 

function long($motl,$mot2) 
{ 

if(strlen($motl)>strlen($mot2)) return -1; 
elseif(strlen($motl)<strlen($mot2)) return 1; 
else return 0; 

} 

La fonction de tri utilisable pour les tableaux indicés est la suivante : 
I void usort($tab,"nom_fonction") 

Elle trie les valeurs des éléments de $tab selon le critère défini dans la fonction dont le 
nom est passé en second paramètre. Les associations entre les indices ou les clés du 
tableau et les valeurs ne sont pas sauvegardées. La fonction ne retourne aucune valeur et 
agit sur le tableau initial, lequel est donc perdu. 

Le listing de l'exemple 5-20 définit une fonction de tri selon la longueur des chaînes, 
utilise la fonction usort( ) et affiche le tableau trié. 

'•^ Exemple 5-20. Tri personnalisé 

<?php 

//TRI SUR UN CRITERE PERSONNALISE 

/ /■k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k'k-k-k-k'k-k 

//Définition de la fonction de tri 

function long($motl,$mot2) 

{ 

if(strlen($motl)==strlen($mot2)) return 0; 
elseif(strlen($motl)>strlen($mot2)) return -1; 
else return 1; 

} 

//Tableau à trier 

$tab=array( "Bl anc" , "Jaune" , "rouge" , "Vert" , "Orange" , "Noi r" , "Emeraude" ) ; 

//Utilisation de la fonction de tri 

echo "Tri selon la longueur des chaînes de caractères<br>" ; 
echo "Tableau initiaKbr />"; 
print_r($tab) ; 
usort($tab,"long"); 

echo "<br />Tableau trié selon la longueur croissante des mots<br />"; 

print_r($tab) ; 

?> 



Nous obtenons le résultat suivant 
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Tri selon la longueur des chaînes de caractères 
Tableau initial 

Array ( [0] Blanc [1] => Jaune [2] => rouge [3] => Vert [4] => Orange [5] 
Noir [6] => Emeraude ) 

Tableau trié selon la longueur décroissante des mots 

Array ( [0] Emeraude [1] => Orange [2] Blanc [3] => rouge [4] => Jaune [5] 
Vert [6] => Noir ) 



Mélanger les valeurs de façon aléatoire 

Certaines applications gèrent des nombres aléatoires, pour des tirages au sort, par exem- 
ple. D'autres affichent des informations dans un ordre différent pour chaque visiteur. 
Dans tous ces cas, vous pouvez utiliser un tableau contenant les informations à afficher et 
mélanger ces éléments de manière aléatoire au moyen de la fonction shuffleO, dont la 
syntaxe est la suivante : 

I void shuffle(array $tab) 

Cette fonction modifie le tableau $tab, dont les valeurs des éléments sont mélangées de 
façon aléatoire. Là encore, le tableau initial est perdu. 

II est recommandé d'initialiser le générateur de nombres aléatoires de PHP en appelant la 
fonction srand( ) avec un paramètre entier avant son utilisation. Les associations des indi- 
ces et des valeurs ne sont pas sauvegardées. 

Exemple 5-21 . Mélange aléatoire des éléments 

<?php 

//Création du tableau de nombres 
$tab = range(l.lO): 
echo "<h4> Tableau initial</h4>" ; 
print_r($tab) ; 

echo "<h4> Mélange en ordre aléatoi re</h4>" ; 
//Initialisation du générateur de nombres aléatoires 
srand(time( ) ) ; 

//Mélange des éléments puis affichage du tableau 
shuffle($tab) ; 
print_r($tab) ; 
?> 

Le listing affiche le résultat suivant : 



Tableau initial 

Array ( [0] 1 [1] => 2 [2] => 3 [3] 4 [4] => 5 [5] => 6 [6] 7 [7] => 8 [8] => 
9 [9] => 10 ) 

Mélange en ordre aléatoire 

Array ( [0] => 4 [1] => 7 [2] 5 [3] => 6 [4] => 8 [5] => 10 [6] => 1 [7] => 3 [8] => 
9 [9] => 2 ) 
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Le mélange étant aléatoire, vous avez évidemment peu de chance de retrouver le même si 
vous testez le script, le paramètre passé à srandO étant l'instant présent en secondes 
fourni par la fonction time( ). 

Trier des tableaux associatifs 

Les fonctions que vous venez d'étudier pourraient s'appliquer également aux tableaux 
associatifs, mais elles ont l'inconvénient de ne pas conserver les associations entre les 
clés et les valeurs, ce qui, pour ce genre de tableau, est rédhibitoire. Vous pourrez donc 
trier soit les clés soit les valeurs. 

Trier des valeurs 

Les fonctions suivantes sont spécialement dédiées aux tableaux associatifs car elles 
préservent toutes les associations entre les clés et les valeurs : 

• void asort(array $tab). Trie les valeurs du tableau $tab selon l'ordre croissant des 
codes ASCII des caractères qui les composent en préservant les associations clé- 
valeur. 

• void arsort(array $tab). Trie les valeurs du tableau $tab selon l'ordre décroissant des 
codes ASCII des caractères qui les composent en préservant les associations clé- 
valeur. 

• void uasort(array $tab,string "nom_fonction"). Joue le même rôle que la fonction 
usort( ), déjà présentée pour les tableaux indicés, en effectuant un tri selon le critère 
défini dans la fonction de comparaison. Elle conserve en outre les clés associées aux 
valeurs. 

Les fonctions natsortO et natcasesort( ), qui permettent de trier les éléments selon 
l'ordre naturel respectivement en tenant compte ou pas de la casse, sont également 
utilisables dans les tableaux associatifs car elles préservent les associations entre les clés 
et les valeurs. 

<^ Exemple 5-22. Tri de tableaux associatifs 

<?php 

//TABLEAUX ASSOCIATIFS 

$tabass= array( "white2"=>"Bl anc2" , "yel 1 ow"=>" Jaune" , "red"=>" rouge" , "green"=>"Vert" . 

blue"=>"Bleu","black"=>"No1r" ,"whitelO"=>"BlanclO") : 
$copieass=$tabass; 

echo "<h4>Tableau associatif d'origine</h4>" ; 
print_r($tabass) ; 

echo "<h4>Tri en ordre alpha des valeurs avec sauvegarde des clés</h4>"; 
$tabass=$copieass; 
asort($tabass) ; 
print_r($tabass) ; 

echo "<h4>Tri en ordre alpha inverse avec sauvegarde des clés</h4>": 
$tabass=$copieass ; 
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arsort($tabass) ; 
print_r($tabass) ; 

echo "<h4>Tri en ordre naturel avec sauvegarde des clés</h4>"; 
$tabass=$copieass; 
natsort($tabass) : 
print_r($tabass) : 

echo "<h4>Tri en ordre naturel insensible à la casse avec sauvegarde des clés</h4>": 

$tabass=$copieass: 

natcasesort($tabass) ; 

print_r($tabass) ; 

?> 

Le listing affiche le résultat suivant : 



Tableau associatif d'origine 

Array ( [whiteZ] => Blanc2 [yellow] Jaune [red] => rouge [green] => Vert [ blue] => 
Bleu [black] => Noir [whitelO] BlanclO ) 
Tri en ordre ASCII des valeurs 

Array ( [whitelO] => BlanclO [white2] => BlancZ [ blue] => Bleu [yellow] Jaune 
[black] Noir [green] => Vert [red] rouge ) 
Tri en ordre ASCII inverse 

Array ( [red] rouge [green] Vert [black] => Noir [yellow] => Jaune [ blue] 
Bleu [white2] => Blanc2 [whitelO] => BlanclO ) 
Tri en ordre naturel avec sauvegarde des clés 

Array ( [white2] => Blanc2 [whitelO] => BlanclO [ blue] => Bleu [yellow] Jaune 

[black] Noir [green] => Vert [red] rouge ) 

Tri en ordre naturel insensible à la casse avec sauvegarde des clés 

Array ( [white2] => Blanc2 [whitelO] => BlanclO [ blue] => Bleu [yellow] Jaune 

[black] Noir [red] => rouge [green] Vert ) 



Trier les clés 

La caractéristique des tableaux associatifs est d'utiliser une clé à la place d'un indice 
numérique. Il peut dès lors être utile d'opérer des tris non plus sur les valeurs mais sur les 
clés des éléments pour afficher les résultats de différentes façons. 

La fonction suivante : 

I boolean ksort(array $tab) 

trie les clés de $tab selon l'ordre croissant des codes ASCII des caractères. Les associa- 
tions clé- valeur sont conservées. Cette fonction retourne une valeur booléenne indiquant 
si l'opération de tri a réussi ou non. 

La fonction suivante permet de trier les clés selon l'ordre décroissant des codes ASCII 
des caractères : 

■ boolean krsort(array $tab) 

Elle conserve également les associations clé -valeur et retourne une valeur booléenne 
indiquant si l'opération de tri a réussi ou non. 
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Comme pour les tableaux indicés, la fonction suivante : 

I void uksortCarray $tab .string "noin_fonction" ) 

permet de trier les clés des éléments de $tab selon le critère personnalisé défini dans la 
fonction passée en second paramètre. La fonction de tri doit retourner -1 ou 1 selon que 
le critère est vérifié ou non ou 0 en cas d'égalité dans les mêmes conditions que la fonc- 
tion usort( ) présentée précédemment. 

L'exemple 5-23 utilise ces fonctions. 
'•^ Exemple 5-23. Tri des clés 

<?php 

//TABLEAU ASSOCIATIF 

$tabass= array( "whi te2"=>"Bl anc2" , "yel 1 ow"=>" Jaune" . "recl"=>" rouge ""green"=> "Vert" , 
*"blue"=>"Bleu"."black"=>"Noir"."whitelO"=>"BlanclO") : 
$copieass=$tabass ; 

echo "<h4>Tableau associatif cl'origine</h4>" ; 
print_r($tabass) ; 

echo "<h4>Tri en ordre ASCII des clés</h4>"; 
$tabass=$copieass; 
ksort($tabass) ; 
print_r($tabass) ; 

echo "<h4>Tri en ordre ASCII inverse des clés</h4>": 
$tabass=$copieass ; 
krsort($tabass) ; 
print_r($tabass) ; 
/ / 

//TRI SUR UN CRITERE PERSONNALISE 

function long($motl,$n)ot2) 
{ 

if(strlen($inotl)>strlen($mot2)) return -1; 
elseif(strlen($motl)<strlen($mDt2)) return 1; 
else return 0; 

} 

echo "<h4>Tri selon la longueur des clés </h4>"; 
uksort($tabass, "long" ) ; 
print_r($tabass) ; 
?> 

Le listing fournit les résultats ci-dessous, dans lesquels le tri des clés se fait selon l'ordre 
ASCII et non pas naturel. C'est pour cette raison qu'il est préférable que les clés aient 
toutes la même casse lors de la création du tableau. 

II est possible de transformer la casse des clés avant le tri en appliquant au tableau la 
fonction array_change_key_case( ), dont la syntaxe est la suivante : 

I array array_change_key_case (array $tab, int CTE) 
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Cette fonction transforme toutes les clés du tableau $tab en minuscules si la constante CTE 
vaut CASE_LOWER (valeur par défaut) ou en majuscules si elle vaut CASEJPPER. 



Tableau associatif d'origine 

Array ( [white2] => Blanc2 [yellow] => Jaune [red] => rouge [green] => Vert [ blue] => 
Bleu [black] => Noir [whitelO] BlanclO ) 
Tri en ordre alpha des clés 

Array ( [ blue] => Bleu [black] => Noir [green] => Vert [red] rouge [whitelO] 
BlanclO [white2] => Blanc2 [yellow] => Jaune ) 
Tri en ordre alpha inverse des clés 

Array ( [yellow] => Jaune [white2] Blanc2 [whitelO] => BlanclO [red] => rouge 
[green] Vert [black] => Noir [ blue] => Bleu ) 
Tri selon la longueur des clés 

Array ( [whitelO] => BlanclO [white2] => Blanc2 [yellow] Jaune [black] => Noir 
[green] Vert [ blue] => Bleu [red] => rouge ) 



Opérer une sélection des éléments 

Lorsqu'un tableau contient un nombre important d'informations, vous pouvez réaliser 
une sélection de ses éléments à l'aide de la fonction array_f i 1 ter( ) et ne retenir que ceux 
qui répondent à une condition particulière définie par le programmeur. 

La syntaxe de la fonction array_f i lter( ) est la suivante : 

I array array_filter(array $tab,string ''nom_f onction") 

Elle retourne un nouveau tableau ne contenant que les éléments de $tab qui répondent à 
la condition définie dans la fonction dont le nom est passé en second paramètre. Le 
tableau initial est conservé. 

L'exemple 5-24 utilise la fonction array^filterO pour sélectionner parmi les éléments 
d'un tableau contenant des noms de villes celles dont l'initiale est "P" ou "p". 

La fonction de sélection doit avoir comme paramètre une variable qui représente la 
valeur d'un élément courant du tableau sur lequel s'effectue la sélection et retourner cette 
variable si elle répond à la condition énoncée. 

'■^ Exemple 5-24. Sélection dans un tableau 

<?php 

//Définition du tableau 

$vil 1 es=array( "Paris" , "Perpignan" , "Marseil 1 e" , "pau" , "Nantes" , "Lil 1 e" ) ; 
//Fonction de sélection 
function init($ville) 
{ 

if($ville[0]=="P" Il $ville[0]=="p" ) 

{ 

return Sville; 
} 

} 



144 



PHP 5 



//Utilisation de array_f i 1 ter( ) 
$select=array_filter($villes,"init") ; 
print_r($select) ; 
?> 

Ce script retourne le tableau $sel ect, dont la structure est la suivante : 



Array ( [0] => Paris [1] => Perpignan [3] => pau ) 



Appliquer une fonction à un tableau 

Si vous souhaitez appliquer une même opération ou fonction à l'ensemble des valeurs 
des éléments d'un tableau, vous pouvez envisager d'effectuer une boucle for ou while et 
d'appliquer la fonction à chacun des éléments lus. Outre l'allongement du code qui en 
résulterait, cette méthode présenterait l'inconvénient de multiplier les appels à la fonc- 
tion de calcul et entraînerait une perte de temps. 

Une façon plus élégante et plus rapide de parvenir au même résultat consiste à utiliser la 
fonction array_wal k( ), qui peut avoir deux syntaxes différentes selon le nombre de para- 
mètres qui lui sont passés. 

Avec deux paramètres la syntaxe de la fonction array_wal k( ) est la suivante : 
I int array_walk($tab,"noin_fonction") 

La fonction dont vous précisez le nom est appliquée à toutes les valeurs des éléments du 
tableau $tab, que ce dernier soit indicé ou associatif. La fonction appliquée aux valeurs 
doit être une fonction personnalisée et non une fonction native de PHP. Elle doit de surcroît 
avoir au moins deux paramètres, le premier faisant référence à la valeur de l'élément de 
tableau à traiter et le second à l'indice ou la clé de cet élément. 

Vous pouvez évidemment détourner l'interdiction d'utilisation d'une fonction native en 
appelant celle-ci dans la fonction personnalisée. Le listing de l'exemple 5-25 utilise cette 
syntaxe pour afficher sous forme de tableau XHTML le tableau de valeurs de la fonction 
cos(?/x) appliquée à toutes les valeurs du tableau $tabx, lequel contient les valeurs entiè- 
res de 1 à 10. 

La figure 5-5 donne le résultat de cet exemple. 

Avec trois paramètres, la syntaxe de la fonction array^wal k( ) est la suivante : 

I array array_wal kCarray $tab,string "nom_fonction", divers param) 

Elle permet d'utiliser la valeur du troisième paramètre param comme troisième paramètre 
de la fonction "nom_f onction". Vous pouvez de la sorte personnaliser l'affichage, comme 
dans le deuxième exemple du listing de l'exemple 5-25, qui utilise ce paramètre pour 
créer la couleur de fond des cellules de la colonne affichant le prix TTC. 
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<^ Exemple 5-25. Application d'une fonction aux éléments d'un tableau 

<?php 

//array_wal k;( ) avec deux paramètres 

$tabx= ranged.lO): 
function tabval ($val ,$ind) 
{ 

echo "<tr><td><b>", $ind+l."</b></td><td>".cos(m_pi /$val ) . "</td></tr>" ; 

} 

echo"<table border=\"3\"><tr> 
<td> <h2>tableau de val eLirs</h2> 
<table border=\"l\" > 

<thead><th> x </th><th> cos(pi/x)</th></thead>": 
array_wal k($tabx, "tabval " ) ; 
echo"</table></td> "; 

^^■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k'k-k-k-k'k-k-k-k'k-k-k 

//array_wal k( ) avec trois paramètres 

/ f-k-k-h-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-^-h-k-k-^-k-k-k-k-k-k-k-k-k 

$prix=array("22"=>"5.50"."32.50"=>"19.60"."80.00"=>"19.60"): 
//fonction de calcul ht et ttc 
function taxe($taux,$prix,$col ) 
{ 

echo "<tr><td > $prix </td><td > $taux </td><td>".$prix*($taux/100) . 
"</td><td style=\"background-color:$col \">" .$prix*( l+$taux/100) . "</td></ tr>": 
} 

echo"<td><h2>facture détai 1 1 ée</h2> 
<table border=\"l\" > 

<thead><th> h.t</th><th> taux</th><th> t.v.a.</th><th> t.t.c. .</th></ thead>"; 

array_wal k($prix, "taxe" , "red" ) ; 

echo"</td></tr></table></table>": 

?> 

PHP propose un autre type de fonction, la fonction array_reduce( ), non pas pour appli- 
quer une fonction à chacun des éléments d'un tableau, comme précédemment, mais pour 
retourner un seul résultat à partir de l'ensemble des valeurs contenues dans le tableau. Cela 
peut permettre, par exemple, de calculer la somme ou le produit de l'ensemble des 
valeurs du tableau. 

La syntaxe de la fonction array_reduce( ) est la suivante : 

I divers array_reduce(array $tab,string "nom_fonction"[ .divers param]) 

Comme le ferait une boucle for, elle applique de façon itérative la fonction dont le nom 
est passé en paramètre à l'ensemble des valeurs du tableau $tab. Le troisième paramètre 
facultatif est considéré comme étant la première valeur du tableau. C'est la valeur retour- 
née par défaut si $tab est vide. 
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1^ Application d'une fonction aux éléments d'un tableau - Mozilla Firefox [ c=> | (h) Ib^^bI 

Fichier Édition Affichage Historique Marque-pages Outils ? 

^ » ^ y L— 1 I http://www.fun htm l.com/phpS/CStableaia/ta bleau25.html ^ ' [ [ |G1 ' | google earth ^ 



Tableau de valeurs d'une fonction 


Facture détaillée 


X 


cos(pi/x) 


ll 


j-l 


{2 


|6.123031769in9E-17 


{3 


|0.5 


h.t taux t.v.a. t.t.c. 


{4 


|0.70710678n8655 


22.00 5.50 1.21 23.21 




|0.80901699437495 


32.50 19.60 6.37 38.87 




|0.86602540378444 


80.00 19.60 15.68 95.68 




|0.90096886790242 


319.00 19.6 62.524 381.524 


|8 


|0.92387953251129 




|9 


|0.93969262078591 | 


|io 


|0.95 10565 16295 15 



Figure 5-5 

Application de fonctions à des tableaux de données 



Le code de l'exemple 5-26 illustre l'utilisation de cette fonction pour calculer d'abord le 
produit d'un nombre de valeurs entières en l'appliquant au calcul de la factorielle d'un 
entier A^. 



Rappel 

La factorielle de N est notée N\. Elle est égale à 1 x 2 x 3 x... A/. Voir à ce sujet la section « Les fonctions 
récursives » au cliapitre 7. 



Le deuxième exemple permet ensuite d'opérer la concaténation répétée de toutes les 
chaînes de caractères contenues dans les éléments d'un tableau. Il utilise comme troi- 
sième paramètre la chaîne de caractères "Sal ut à", qui constituera les premiers mots de 
tous les résultats retournés, quel que soit le tableau. 

Exemple 5-26. La fonction array_reduce() 

<?php 

//Définition de la fonction produit 
function multi ($a,$b) 

{ 

if($a==0) $a=l: 
return $a*$b; 
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//array_reduce avec deux paramètres 
$n=10; 

$tabn= range(l,$n): 
$prod=array_reduce($tabn , "mul ti " ) ; 

echo "<hr />Produit des éléments = factorielle $n = $n! = ",$prod: 
//Définition de la fonction de concaténation 
function concat($a,$b) 
{ 

$a.=$b: 
return $a: 
} 

// array_reduce avec trois paramètres 

$tabch= arrayCmessieurs "," Hulot", " et "," Tati"); 

$chaine=array_reduce($tabch,"concat", "Salut à "); 

echo "<hr>Concaténation des éléments : ",$chaine: 

?> 

Le script de l'exemple 5-26 affiche les résultats suivants : 



Produit des éléments = factorielle 10 = 10! = 3628800 
Concaténation des éléments : Salut à messieurs Hulot et Tati 



L'objet ArrayObject 

A l'instar de ASP.Net, PHP 5 introduit un objet prédéfini ArrayObject représentant un 
tableau. Il permet de créer des tableaux qui ne sont pas du type array mais object. Ces 
objets possèdent des méthodes qui permettent d'effectuer diverses opérations. Si vous 
n'êtes pas familiarisé avec les notions d'objet et de méthode reportez-vous au préalable 
au chapitre 9. 

Pour créer un objet tableau, utilisez le mot-clé new selon la syntaxe suivante : 
I $objtab=new ArrayObject( ) ; 

qui appelle le constructeur de l'objet. Le tableau créé est alors vide. Pour lui affecter des 
éléments au moment de sa création, vous pouvez passer au constructeur un paramètre qui 
est un tableau PHP classique de type array selon le modèle suivant : 

|$tab = array( "Linux" , "Apache" ) ; 
$objtab = new arrayObject($tab) ; 

Le tableau passé en paramètre au constructeur peut également être un tableau associatif, 
selon le modèle suivant (repères O et 0 de l'exemple 5-27) : 

|$tab = array( ' a '=>"Linux" , 'b'=>"Apache" ) : <— © 
$objtab = new arrayObjectCStab) ; <— 0 

La méthode append( ) permet d'ajouter des éléments au tableau un par un (repères 0, Q 
et 0). Sa syntaxe est la suivante : 

I $objtab->append("PHP 5"): 
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L'élément ajouté a l'indice immédiatement supérieur au dernier existant dans la tableau. 
Ici, l'élément de valeur "PHP 5" aura l'indice 0 car les indices précédents sont des chaînes. 

La boucle f oreach étant applicable aux objets, elle permet de lire l'ensemble des clés (ou 
des indices) et les valeurs associées contenues dans le tableau (repère 0). 

L'équivalent de la fonction count( ) applicable au type array est la méthode count{ ), qui 
permet de lire le nombre d'éléments de l'objet tableau (repère Q). 

Il est encore possible de récupérer les clés et les valeurs contenues dans l'objet dans un 
tableau associatif habituel de type array en appliquant la méthode getArrayCopy( ) à 
l'objet (repère©). L'affichage de ce tableau avec la fonction print_r() (repère 0) 
confirme que la variable obtenue est du type non plus object mais array. Vous pourriez 
alors appliquer à cette variable une des fonctions applicables aux tableaux que vous avez 
vues dans les sections précédentes. 

Vous pouvez vérifier l'existence d'un élément d'indice ou de clé donné en utilisant la 
méthode offsetExistsC ), qui retourne TRUE si l'élément existe et FALSE sinon (repère ®)- 

Pour lire un élément du tableau, connaissant son indice ou sa clé, vous utilisez la méthode 
offsetGetO, dont la syntaxe est la suivante : 

I echo $objtab->offsetGet(cle) ; 

Le paramètre est un nombre ou une chaîne de caractères selon les cas (repère 0). 

Pour ajouter un élément en précisant sa clé numérique ou alphabétique, vous devez appe- 
ler la méthode offsetSet( ), dont la syntaxe est la suivante : 

I $objtab->offsetSet(cle, val eur) ; 

Le paramètre cle est également un nombre ou une chaîne de caractères selon les cas 
(repères 0 et ©). L'affichage du tableau (repère ©) permet de contrôler l'insertion des 
éléments. 

Vous pouvez enfin supprimer un élément au moyen de la méthode offsetUnsetC ) en lui 
donnant comme paramètre l'indice ou la clé de l'élément à supprimer (repère ©). Là 
aussi, vous affichez le tableau pour vérifier la suppression de l'élément (repère ©). 

Exemple 5-27. Création et manipulation d'un objet ArrayObject 

<?php 

$tab = array( 'a'=>"Linux" , 'b'=>"Apache") : <— 0 
//Création de l'objet ArrayObject 
$objtab =new ArrayObject($tab) ; <— 0 
//Ajout de trois éléments 
$objtab->append("PHP 5"):<-0 
$objtab->append("MySQL"): <— 0 
$objtab->append("SQL1te") : <— 0 
//Lecture des éléments 
foreach($objtab as $cl e=>$val ) <— 0 
{ 

echo "$cle : $val<br />"; 



Les tableaux 

Chapitre 5 



} 

echo "<hr />"; 

//Affichage du nombre d'éléments 

echo "Nombre d'éléments = " ,$objtab->count( ) ; <— © 

//Copie dans un tableau array 

$tab2=$objtab->getArrayCopy( ) ; <— © 

print_r($objtab2) : <— 0 

echo "<hr />"; 

//Vérification de l'existence d'un élément d'indice ou de clé donné 
$val = 'a' ; 

if($objtab->offsetExists($val )) ^(J) 
{ 

echo "L'élément d'indice $val existe dans le tableau. "; 

echo "Il a la valeur : " , $objtab->offsetGet($val ) , "<br />";^© 

} 

echo "<hr />"; 

//Ajout d'un élément d'indice ou de clé donné 
$objtab->offsetSet(3, 'SimpleXML' ) : <-© 
$objtab->offsetSet( 'c' , ' ArrayObject ' ) ; <— © 
print_r($objtab) ; <— © 
echo "<hr />"; 

//Suppression d'un élément d'indice donné 
$objtab->offsetUnset(3); <— © 
print_r($objtab) ; <— © 
?> 

Cet exemple affiche les résultats suivants, qui illustrent les possibilités offertes par les 
méthodes de l'objet ArrayObject. 



a : Linux 
b : Apache 

0 : PHP 5 

1 : MySQL 

2 : SQLite 

Nombre d'éléments = 5 

Array ( [a] Linux [b] => Apache [0] PHP 5 [1] => MySQL [2] => SQLite ) 
L'élément d'indice a existe dans le tableau. Il a la valeur :Linux 

ArrayObject Object ( [a] => Linux [b] => Apache [0] => PHP 5 [1] => MySQL [2] SQLite 
[3] SimpleXML [c] => ArrayObject ) 

ArrayObject Qbject ( [a] => Linux [b] => Apache [0] PHP 5 [1] => MySQL [2] SQLite 
[c] ArrayObject ) 



Le nombre de méthodes disponibles actuellement pour l'objet ArrayObject est assez 
limité, mais nul doute qu'il va progresser dans l'avenir, ce qui le rendra aussi riche de 
méthodes que le type array doté de très nombreuses fonctions spécifiques. 
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Mémo des fonctions 

Les tableaux, qu'ils soient indicés, associatifs ou multidimensionnels, fournissent un 
type de donnée riche de possibilités pour le stockage d'informations. Pour bien utiliser 
ces tableaux, vous devez en avoir une bonne connaissance car vous les retrouverez dans 
tous les types de scripts. 

PHP fournit un grand nombre de fonctions natives permettant les opérations les plus 
diverses, allant de la création aux manipulations les plus variées. Là encore, la connais- 
sance de ces possibilités est gage d'efficacité dans l'écriture de scripts. 

array_change_key_case(array $tab, int cte) 

Modifie ia casse des clés du tabieau $tab. La constante CTE vaut CASE_UPPER pour les majuscules ou CASE_LOWER pour 
les minuscuies. 

array_cliunk(array $tab, int NB [, boolean CLE]) 

Scinde le tableau $tab en un tableau multidimensionnel dont chaque élément est un tableau indicé contenant NB 
éléments de $tab. Le paramètre CLE indique s'il faut conserver les indices initiaux (TRtJE pour oui). 

array array_combine(array $tabclé, array $tabval) 

Crée un tableau associatif dont les clés sont les éléments de $tabcl é et les valeurs ceux des Stabval . 
array_count_val uesCarray $tab) 

Compte le nombre d'occurrences de chaque valeur des éléments de $tab et retourne un tableau dont les clés sont les 
valeurs du tableau $tab et les valeurs le nombre d'occurrences. 

array array_diff ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau qui est la différence ensembliste des tableaux $tabl et $tab2. Il contient les éléments de $tabl 
moins ceux qui sont communs aux deux tableaux. Vous pouvez généraliser avec N tableaux. 

array array_fil 1 (integer départ, int N, divers valeur) 

Retourne un tableau dont tous les éléments d'indices compris entre départ et depart+N ont la valeur contenue dans le 
paramètre val eur. 

array array_f i 1 ter(array $tab,string nom_fonction) 

Supprime tous les éléments de $tab pour lesquels la fonction de tri passée en deuxième paramètre retourne FALSE. 
array array_fl ip(array $tab) 

Retourne un tableau associatif qui a pour clés les valeurs des éléments de $tab et pour valeurs les clés de $tab. 
array array_intersect_assoc ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau associatif contenant les éléments ayant même clé et même valeur pour les tableaux $tabl, $tab2, 
$tabN. 

array array_intersect ( array $tabl. array $tab2 [, array $tabN]) 

Retourne un tableau contenant les éléments ayant la même valeur dans les tableaux $tabl, $tab2, $tabN. 
bool array_key_exists ( divers cle, array $tab) 
Retourne TRUE si la clé (ou l'indice) de valeur cle existe dans $tab. 
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array array_keys ( array $tab [, divers val]) 

Retourne un tableau contenant uniquement les clés de $tab. SI le paramètre val est précisé, le tableau retourné contient 
la position des clés ayant la valeur val . 

array array_map ( string noni_f onction, array $tabl [, array $tab2 $tabN]) 

Applique la fonction indiquée à tous les éléments des tableaux $tabl, $tab2, $tabN. 
array array_merge ( array $tabl, array $tab2 [, array $tabN]) 

Retourne un tableau rassemblant tous les éléments des tableaux $tabl, $tabN. Si les clés sont identiques, c'est celle 
du dernier tableau qui l'emporte. 

bool array_inul ti sort ( array $tabl [, ctel,cte2 [,... [, array $tabN,ctel,cte2]]]) 

Trie plusieurs tableaux $tabl $tabN selon les critères précisés pour chacun d'eux par les constantes ctel et cte2. 

Ces constantes ont pour valeurs : 

ctel SORT_ASC : tri en ordre croissant (par défaut) ou SORT_DESC : tri en ordre décroissant. 

cte2 SORT_REGULAR : comparaison alpfiabétique ou SORT_NUMERIC : comparaison numérique ou SORT_STRING : 
comparaison des cfiaînes. 

array array_pad ( array $tab, int N, divers val) 

Retourne un tableau contenant les éléments de $tab auxquels sont ajoutés plusieurs fois la valeur val pour obtenir W 
éléments au total. Si W > 0 les éléments sont ajoutés au début sinon à la fin. 

divers array_pop ( array $tab) 

Supprime le dernier élément de $tab et retourne sa valeur. 

int array_push ( array $tab, divers $varl[, divers $varN]) 

Ajoute les valeurs $varl, $varN à la fin du tableau $tab et retourne la taille du nouveau tableau, 
divers array_rand ( array $tab [, int N]) 

Choisit N éléments au hasard dans $tab et retourne un tableau contenant les clés des éléments choisis. Si N vaut 1 la 
fonction retourne une chaîne contenant sa clé. 

divers array_reduce ( array $tab, string noin_fonction [, int N]) 

Applique la fonction précisée à l'ensemble des éléments de $tab et retourne une valeur unique calculée à partir de ces 
valeurs (par exemple, la somme de tous les éléments). Si le paramètre N est passé, il est inclus dans les calculs comme 
valeur initiale. 

array array_reverse ( array $tab [, bool cle]) 

Inverse l'ordre des éléments du tableau. Préserve les clés si le paramètre cle vaut TRUE. 

mixed array_shift ( array $tab) 

Supprime le premier élément du tableau et retourne cet élément. 

array array_slice ( array $tab, int N [, int L]) 

Retourne un tableau contenant L éléments extraits de $tab et dont le premier a l'indice N. 
array array_splice ( array $tab, int N [, int L [, array $tab2]]) 

Supprime L éléments de $tab à partir de l'indice N et les remplace éventuellement par ceux du tableau $tab2. 
ïïiixed array_sum ( array $tab) 
Retourne la somme des éléments du tableau. 
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array array_um'que ( array $tab) 

Élimine les doublons et retourne un nouveau tableau. 

int array_unshift ( array $tab, divers $varl [, divers $varN]) 

Ajoute les valeurs contenues dans les variables $varl, $varN à la fin du tableau et retourne le nombre d'éléments 
ajoutés. 

array array_values ( array $tab) 

Retourne un tableau ne contenant que les valeurs du tableau associatif $tab. Crée des indices numériques de 0 à W. 
bool array_walk ( array $tab. string nom_fonction) 

Applique la fonction indiquée à tous les éléments de $tab. Si la fonction a plusieurs paramètres, les éléments sont passés 
comme premier paramètre. Retourne TRUE si l'opération est réussie et FALSE sinon. 

bool arsort ( array $tab ) 

Trie le tableau associatif $tab en ordre décroissant des valeurs et en préservant les clés. Retourne TRUE si l'opération est 
réussie et FALSE sinon. 

bool asort ( array $tab [, int sort_flags]) 

Tri le tableau associatif $tab en ordre croissant des valeurs et en préservant les clés. Retourne TRUE si l'opération est 
réussie et FALSE sinon. 

array compact ( divers $varl [.divers $varN]) 

Crée un tableau dont les éléments sont les valeurs des variables $varl, $varN. Ces variables peuvent être des 
tableaux. 

int count ( array $tab [, int COUNT_RECURSIVE] ) 

Retourne le nombre d'éléments de $tab. Pour obtenir le nombre d'éléments d'un tableau multidimensionnel, il faut utiliser 
le deuxième paramètre. 

mixed current ( array $tab) 

Retourne la valeur de l'élément pointé par le pointeur du tableau, 
array each ( array $tab) 

Retourne la clé (ou l'indice) et la valeur de l'élément en cours dans un tableau à quatre éléments. Les éléments d'indice 
0 et l<ey contiennent la clé de l'élément de $tab. Les éléments 1 et val ue contiennent la valeur associée. 

divers end ( array array) 

Place le pointeur de tableau sur le dernier élément et retourne sa valeur. 

int extract ( array $tab [, int N [. string préfixe]]) 

Crée des variables dont les noms sont les clés de $tab et les valeurs celles de ses éléments. 

bool in_array ( divers val, array $tab [, bool type]) 

Retourne TRUE si la valeur val est présente dans le tableau $tab. Si le paramètre type vaut TRUE les types de la valeur 
recherchée et de l'élément doivent être identiques. 

divers key ( array $tab) 

Retourne la clé de l'élément actuellement pointé dans $tab. 
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bool krsort ( array $tab) 

Trie $tab selon les clés en ordre décroissant. Les associations clé/valeur sont préservées, 
bool ksort ( array $tab) 

Trie $tab selon les clés en ordre croissant. Les associations clé/valeur sont préservées, 
void list ( $varl $varN) 

Permet d'affecter une liste de variables avec les éléments du tableau $tab. 

void natcasesort ( array $tab) 

Trie le tableau en ordre naturel sans tenir compte de la casse. 

divers next ( array $tab) 

Retourne l'élément suivant de $tab ou FALSE en fin de tableau, 
mixed prev ( array $tab) 

Retourne l'élément précédent de $tab ou FALSE en fin de tableau, 
array range ( int min, int max [, int pas]) 

Crée un tableau contenant une suite d'entiers incrémentée de une unité par défaut, en commençant à la valeur mi n et en 
finissant à max. Le paramètre éventuel ne modifie pas cet incrément. 

mixed reset ( array $tab) 

Replace le pointeur de tableau sur le premier élément et retourne cette valeur. 

bool rsort ( array $tab [, int sort_flags]) 

Trie les éléments de $tab en ordre décroissant 

void sliuffle ( array $tab) 

Mélange tous les éléments du tableau au hasard. 

bool sort ( array $tab [, int sort_flags]) 

Trie les éléments de $tab en ordre croissant. 

bool uasort ( array $tab, string nom_foncticn) 

Trie les éléments du tableau associatif $tab en fonction d'un critère de comparaison défini par la fonction personnalisée 
nom_f onction. Les clés sont préservées. 

bool uksort ( array $tab, string nom_fonction) 

Trie les clés de $tab en fonction d'un critère de comparaison défini par la fonction personnalisée nom_f onction, 
bool usort ( array $tab, string nom_fonction) 

Trie les éléments de $tab en fonction d'un critère de comparaison défini par la fonction personnalisée nom_f onction. 
Les clés sont préservées. 
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Exercices 

Exercice 1 

Écrivez un tableau multidimensionnel associatif dont les clés sont des noms de personne 
et les valeurs des tableaux indicés contenant le prénom, la ville de résidence et l'âge de la 
personne. 

Exercice 2 

Écrivez un tableau multidimensionnel associatif dont les clés sont des noms de personne 
et les valeurs des tableaux associatifs dont les clés sont le prénom, la ville de résidence et 
l'âge de la personne avec une série de valeurs associées. 

Exercice 3 

Utilisez une boucle foreach pour lire les tableaux des exercices 1 et 2. 
Exercice 4 

Utilisez une boucle whi 1 e pour lire les tableaux des exercices 1 et 2. 
Exercice 5 

Créez un tableau contenant une liste d'adresses de sites recommandés, puis créez un lien 
aléatoire vers le premier site de la liste après avoir trié le tableau en ordre aléatoire. 

Exercice 6 

Créez un tableau d'entiers variant de 1 à 63 puis, à partir de celui-ci, un autre tableau de 
nombres variant de 0 à 6.3. Créez ensuite un tableau associatif dont les clés X varient 
de 0 à 6.3 et dont les valeurs sont sin(X). Affichez le tableau de valeurs dans un tableau 
XHTML. 

Exercice 7 

Créez un tableau contenant une liste d'adresses e-mail. Extrayez le nom de serveur de ces 
données, puis réalisez des statistiques sur les occurrences de chaque fournisseur d'accès. 
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Les formulaires introduits dans le HTML depuis ses plus anciennes versions sont 
l'élément essentiel qui permet l'interactivité entre un site et ses visiteurs. Ils constituent 
pour cette raison la base de la création de sites dynamiques. L'envoi d'informations du 
poste client vers le serveur via le protocole HTTP concerne aussi bien l'envoi des 
données personnelles d'un internaute qui souhaite passer une commande que le déclen- 
chement d'une requête dans une base de données ou la création de page dynamique en 
réponse à cette demande. 

Tout échange entre visiteur et serveur passe par un formulaire, dans lequel l'utilisateur 
peut saisir textes ou mots de passe, opérer des choix grâce à des boutons radio, des cases 
à cocher ou des listes de sélection, voire envoyer ses propres fichiers depuis le poste 
client. Il est donc important d'en maîtriser la création à la fois avec XHTML 1.1, pour 
obtenir des formulaires présentables, et avec PHP, pour gérer les informations fournies 
par le formulaire au script côté serveur. 

Création d'un formulaire HTIVIL 

Avant toute chose, il faut créer la structure XHTML d'un formulaire. 

Pour être conforme au XHTML 1.1, le document contenant le formulaire doit avoir la 
structure minimale suivante : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Titre de la page</tit1 e> •^O 
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</head> 
<body> 

<forin method="post" action="nomdefichier.php"> 
<fieldset> 
<legend>Titre du formul ai re</l egend> 

<!-- Corps du formulaire contenant les différentes composants--> 
</fieldset> <-0 
</forni> 
</body> 
</html> 

L'élément <form> possède certains attributs obligatoires. D'autres sont utilisés dans des 
circonstances particulières en fonction des besoins. 

L'attribut action="nom_de_fichier.php" (repère Q) ^st obligatoire. Il désigne le fichier 
qui va traiter, sur le serveur, les informations saisies dans le formulaire. Il est recom- 
mandé que ce fichier soit présent dans le même répertoire que celui contenant le formu- 
laire, mais ce n'est pas obligatoire. Si le fichier se trouve dans un autre dossier, voire sur 
un autre serveur, il faut utiliser une adresse absolue, en écrivant, par exemple : 

I act1on= "http://www.abcphp.com/dossier/nom_de_fichier.php" 

Dans le cadre de ce livre, il s'agira toujours d'un fichier PHP. Il existe d'autres solutions 
sur des serveurs non-PHP, comme ASPNet, qui est un concurrent de PHP. 

Pour que le fichier qui traite les données soit à coup sûr celui qui contient le formulaire, 
vous pouvez utiliser la variable $_SERVER["PHP_SELF"], qui contient le nom du fichier en 
cours d'exécution comme valeur de l'attribut action. Pour les versions antérieures à 
PHP 4.1, il fallait utiliser la variable $PHP_SELF. En cas de maintenance du code entraînant 
le changement du nom du fichier, il n'est pas nécessaire de modifier la valeur de l'attribut 
action. 

Vous pouvez avoir, par exemple, le code suivant : 

I <form method="post" action="<?= $_SERVER["PHP_SELF"] ?>"> 

L'attribut action="nom_de_f ichier.php" peut aussi avoir la valeur "mailto: ", qui provoque 
l'envoi des données vers une adresse e-mail, qu'il faut préciser à la suite du mot mal 1 to en 
écrivant, par exemple : 

I action="mailto: nom@abcphp.com" 

Cette méthode ne peut servir qu'à envoyer des informations vers un mail mais pas vers 
une base de données. Comme elle ne permet pas de les traiter facilement, elle ne nous est 
pas très utile en PHP. 

inethod="post | get" détermine la méthode d'envoi des données vers le serveur. La méthode 
get, qui est la méthode par défaut, présente l'inconvénient d'ajouter les données du 
formulaire à l'adresse URI du fichier qui les traite, ce qui les rend visibles par le visiteur. 
Cet inconvénient peut être exploité pour passer des données à un script dès son appel. 
De plus, il existe une limite à la longueur des URI et donc à la quantité de données à 
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transmettre. Ces problèmes ne se retrouvent pas avec la valeur post, que vous utiliserez 
dans la plupart des cas. 

name="chaine_de_caractères" attribue un nom au formulaire. Cet attribut est surtout utilisé 
pour accéder aux éléments du formulaire via un script JavaScript. 

enctype="type_d' encodage" détermine le type d'encodage des données transmises au 
serveur. Sa valeur par défaut, "application/x-www-forrti-urlencoded", est utilisable dans la 
plupart des cas, à l'exception du transfert de fichiers du poste client vers le serveur, pour 
lequel elle doit être "multipart/form-data". Si l'attribut action a la valeur "mailto:", 
l'attribut enctype a pour valeur "text/plain" ou "text/html ", selon que le contenu est 
envoyé à une adresse e-mail au format texte ou XHTML. 

L'élément <fieldset> (repère 0) permet, à l'intérieur d'un même formulaire, de créer 
des blocs visuels contenus entre les balises <f i el dset> et </f i el dset> et donc de structurer 
le formulaire en fonction des champs qu'il contient, ce qui améliore la présentation. 
L'élément <1 egend> contient le titre de chacun de ces blocs. A l'intérieur de chaque bloc se 
trouvent les éléments XHTML qui créent les champs visibles ou invisibles du formulaire. 

Les sections qui suivent rappellent les différents composants XHTML d'un formulaire et 
leurs rôles respectifs. 

Lélément <input l> 

La balise unique <input /> permet de créer les composants classiques des formulaires 
que vous connaissez déjà et dont les aspects et les rôles sont très différents. La différen- 
ciation de ces composants s'effectue simplement en définissant la valeur de leurs attributs, 
et notamment de l'attribut type. 

L'attribut name est obligatoire, car c'est lui qui permet d'identifier les champs côté 
serveur et ainsi de récupérer leur contenu. Les sections qui suivent détaillent les éléments 
de type "text", "password", "checkbox", "radio", "submit", "reset", "file" et "hidden". 

L'élément <input type="text" l> 

Cet élément crée un champ de saisie de texte d'une seule ligne. En plus de l'attribut name, 
vous pouvez apporter des précisions supplémentaires à l'aide des attributs suivants : 

• size="nombre". Détermine la largeur de la zone en nombre de caractères. 

• riaxlength="nombre". Détermine le nombre maximal de caractères que l'utilisateur est 
autorisé à saisir. 

• val ue="texte". Définit un texte par défaut tant que l'utilisateur ne l'a pas modifié. 
C'est cette valeur qui est transmise au serveur si l'internaute ne saisit aucun texte, 
comme dans l'exemple ci -dessous : 

I <input type ="text" name="v111e" size="30" maxl ength="40" value="Votre ville"/> 
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L'aspect visuel de ce composant est illustré à la figure 6-1 (repères O, ©, Q et 0). 



L'attribut value 

Pour des raisons d'ergonomie, ii est préférabie que ie texte par défaut défini à l'aide de l'attribut value 
s'efface tout seul au moment où l'utilisateur clique dessus car cela lui évite de devoir l'effacer. 
Il suffit pour cela d'utiliser une Instruction JavaScript très simple : 
Pour réagir à l'événement clic : 

<input type ^'lexf nanie="ville" size="30" maxl ength="40" value="Votre ville" 
onclick="this. values' ' "/> 

Pour que le texte s'efface dès que la zone de texte reçoit le focus (le curseur passe dans la zone) : 

<inpLit type ^'lexf nanie=''ville" size="30" maxl ength="40'' val ue=''Votre ville" 
onfocus="this. values' ' "/> 

L'élément <input type="password" l> 

Crée un champ de saisie de mot de passe semblable à un champ texte mais dans lequel les 
caractères saisis sont invisibles et remplacés par des astérisques. 

Les attributs size et maxlength y jouent le même rôle que précédemment. 

En voici un exemple : 

I <1nput type ="password" name="code" size="10" maxl ength="6"/> 

L'élément <input type="checkbox" l> 

Crée une case à cocher utilisée pour effectuer un ou plusieurs choix parmi ceux qui sont 
préétablis par le programmeur. L'attribut value contient le texte qui sera transmis au 
serveur si l'utilisateur coche la case. Il est obligatoire. 

Dans les groupes de cases à cocher, il est possible de cocher plusieurs cases simultané- 
ment, ce qui n'est pas le cas des cases d'option (boutons radio). Dans ce cas, il faut que 
le nom de tous les composants soit le même et qu'il soit suivi de crochets ouvrants et 
fermants de façon à récupérer les valeurs dans un tableau, comme vous le verrez en détail 
par la suite. 

En voici un exemple : 

|<1nput type ="checkbox" name="lang[]" val ue="f rançai s" /> 
<1nput type ="checkbox" name="lang[]" value="angla1s" /> 

L'aspect visuel de ce composant est illustré à la figure 6-1 (repère Q). 
L'élément <input type="radio" l> 

Crée un bouton radio. Employé seul, un bouton radio peut servir à valider des choix. 
Employé en groupe, il implique, à la différence de cases à cocher, qu'un seul choix est 
autorisé. Dans ce cas, tous les boutons radio du groupe doivent avoir une même valeur 
pour l'attribut "name". Le fait d'en activer un désactive celui qui l'était auparavant. 
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L'attribut checked="checked" définit le bouton coché par défaut. L'attribut value joue le 
même rôle que pour les cases à cocher et est également indispensable. 

Voici un exemple d'utilisation de l'élément "radio" : 

I<label>Débutant</label><input type ="radio" name="capa" val ue="débutant" /> 
<label>Initié</label><input type ="radio" nanie="capa" value="initié" /> 

L'aspect visuel de ce composant est illustré à la figure 6-1 (repère 0). 
L'élément <input type="submit" l> 

Crée un bouton sur lequel l'utilisateur doit cliquer pour déclencher l'envoi des données 
de tout le formulaire vers le serveur. 

Il est indispensable d'avoir au moins un bouton d'envoi par formulaire, mais il est possible 
d'en utiliser plusieurs. Le clic sur l'un de ces boutons est alors analysé par le script dési- 
gné par l'attribut action de l'élément <form>. Cela permet d'effectuer des tâches spéciali- 
sées en fonction de la valeur associée à chaque bouton grâce à son attribut val ue. C'est le 
contenu de l'attribut val ue qui constitue le texte visible du bouton dans le formulaire. 

Vous pourrez voir des exemples d'utilisation de plusieurs boutons d'envoi à la fin de ce 
chapitre ainsi qu'au chapitre 13. L'attribut name n'est a priori pas utile, en particulier s'il 
n'y a qu'un seul bouton d'envoi. 

Voici un exemple simple d'utilisation de l'élément "submit" : 
I <input type ="subinit" val ue="Envoyer" /> 

L'aspect visuel de ce composant est illustré à la figure 6-1 (repère ®). 
L'élément <input type="reset" l> 

Crée un bouton de réinitialisation du formulaire et non d'effacement systématique, 
comme on le croit souvent. Si les éléments du formulaire ont des attributs value qui 
définissent des valeurs par défaut, ce sont ces valeurs qui apparaissent au démarrage de la 
page et qui sont réaffichées si l'utilisateur clique sur le bouton reset. 

Le contenu de l'attribut val ue du bouton d'effacement constitue le texte visible du bouton 
dans le formulaire. 

En voici un exemple : 

I <input type ="reset" val ue="Ef facer" /> 

L'aspect visuel de ce composant est illustré à la figure 6-1 (repère ©). 
L'élément <input type="file" l> 

Permet le transfert de fichiers du poste client vers le serveur. Cet élément crée un champ 
de saisie de même aspect qu'un champ de texte et un bouton de sélection de fichier 
permettant à l'utilisateur de choisir le fichier à transférer. 
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L'attribut name est obligatoire. Vous pouvez utiliser en plus les attributs size limitant la 
taille de la zone de saisie, et plus particulièrement l'attribut accept, qui définit le ou les 
types de fichier acceptés en transfert. Par sécurité, l'utilisation de cet attribut est recom- 
mandée car il permet de limiter le transfert à certains types de fichiers bien précis et de 
refuser les autres. 

Dans l'exemple ci -dessous, le serveur n'accepte que le transfert de fichiers ayant les 
extensions .gif ou . jpeg et refuse tout autre type : 

I <input type="file" nanie="monfichier" accept="image/gif ,image/jpeg" size="30"/> 
L'aspect visuel de ce composant est illustré à la figure 6-1 (repère Q). 

L'élément <input type="hiclden" l> 

Crée un champ caché n'ayant, comme son nom l'indique, aucun rendu visuel dans le 
formulaire mais permettant de transmettre des informations invisibles pour l'utilisateur. 

Les informations sont contenues dans l'attribut value. L'attribut name est obligatoire. 

En voici un exemple : 

I <input type="hidden" name="MAX_FILE_SIZE" val ue="20000"/> 

Lélément <textarea> 

À l'instar de l'élément <input /> avec l'attribut type^text, l'élément <textarea> crée un 
champ de saisie de texte mais, contrairement au précédent, en permettant la saisie sur 
plusieurs lignes. 

Cet élément comporte une balise de fermeture </textarea> et un contenu de texte par 
défaut affiché dans la zone de texte. Les attributs col s et rows, qui donnent respectivement 
le nombre de colonnes et de lignes de la zone de texte, doivent être définis. 

L'exemple suivant : 

<textarea name="commentai re" cols="45" rows="8" > 
Tapez vos commentaires ici 
</textarea> 

crée une zone de saisie de texte de 45 colonnes et 8 lignes au maximum. 
L'aspect visuel de ce composant est illustré à la figure 6-1 (repère ©). 

Lélément <select> 

Crée une liste de sélection d'options parmi lesquelles l'utilisateur fait un choix, chaque 
option devant être définie par un élément <option> séparé. 

L'élément <select> a la structure suivante : 

|<select name="mal i ste"> 
<option val ue="val eur 1"> Texte choix l</option> 
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I<option val ue="val eur 2"> Texte choix 2</option> 
<option val ue="val eur 3"> Texte choix 3</option> 
</select> 

Il comporte les attributs suivants : 

• name="nom_sel ect". Obligatoire. Donne le nom de la liste. 

• size="Nombre". Détermine le nombre de choix visibles simultanément. Par défaut, sa 
valeur est 1 . 

• mul ti pl e="mul ti pl e". Autorise la sélection de plusieurs options simultanément. 
L'élément <option> comporte les attributs suivants : 

• val ue=" chai ne". Obligatoire. Définit la valeur transmise au serveur si l'option est sélec- 
tionnée. 

• selected="selected". Définit l'option qui est sélectionnée par défaut dans la liste si 
l'utilisateur ne fait pas de choix. 

L'aspect visuel de ce composant est illustré à la figure 6-1 (repère ©). 



Exemple de code <form> 

L'exemple 6-1 fournit le code d'un formulaire contenant tous les éléments possibles 
répartis en trois groupes : 

• saisie des données personnelles du visiteur et zones de texte « nom », « prénom » et 
« mail » (repères O, Q et 0), champ de saisie de mot de passe (repère O), boutons 
radio (repère 0) et de sélection (repère ©) à quatre options ; 

• cases à cocher (repère et zone de texte multiligne (repère 0) ; 

• envoi d'un fichier du client vers le serveur (repère 0), champ caché contenant la taille 
maximale des fichiers transférables et boutons de réinitialisation (repère et d'envoi 
(repère ©). 

'•^ Exemple 6-1 . Formulaire type 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 
<titl e>Formul ai re traité par PHP</title> 
<style type="text/css"> 

fieldset {border-width: 3px; border-style: double; border: #993300} 

</style> 

</head> 

<body> 
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<form action="cible.php" method="post" enctype="application/x-www-form-urlencoded"> 
<!-- Premier groupe de composants--) 
<fieldset> 
<legend><b>Vos coordonnées</b></legend> 

<label>Nom : </label><input type="text" name="nom" size="40" maxl ength="256" 
*»val ue="votre nom" /Xbr /> <— O 

<1 abel >Prénoin : </label><input type="text" name="prenoin" size="40" 
^maxl ength="256" value="votre prénom" /Xbr /> <— 0 

<label>Mail : </label><input type="text" naine="inai 1 " size="40" inaxlength="256" 
^val ue="votre mail" /Xbr /> <— @ 

<label>Code : </label><input type="password" name="code" size="40" 
^maxlength="6" /> <br /> •^O 

<input type="radio" name="sexe" val ue="homme" /> Homme<br /><—Q 

<input type="radio" name="sexe" val ue="femme" /> Femme<br /> 

<select name="pays" size="r'><— © 

<option val ue="France"> France</option> 

<option val ue="Bel gique"> Belgique</option> 

<option val ue="Suisse"> Suisse</option> 

<option val ue="Canada"> Canada</option> 

</select> 

<br /> 
</fieldset> 
<!-- Deuxième groupe de composants--) 
<fieldset> 

<legend><b>Vos goûts</b></l egend> 
<input type="checkbox" name="pomme" val ue="pomme" /> Pommes<br /> <— © 
<input type="checkbox" name="po1re" val ue="poi re" /> Poires<br /> 
<input type="checkbox" name="scoubidou" val ue="scoubidou" /> Scoubidous<br /> 

<textarea name="gouts" cols="50" rows="5" oncl ick="this . val ue=' ' "><— © 
Décrivez vos goûts en détail 

</textarea> 

<br /Xbr /> 
</fieldset> 
<!-- Troisième groupe de composants--) 
<fieldset> 

<legend><b>Envoyez nous votre photo</b></l egend> 
<input type="f11e" name="fich1er" accept="image/jpeg" /> <— © 
<input type="h1dden" name="MAX_FILE_SIZE" val ue="10000" /> 
<br /Xbr /> 

<input type="reset" val ue="Ef f acer" /> <— © 
  &nbsp:<input type="submit" val ue="Envoyer" /><— ® 
<br /Xbr /> 
</fieldset> 

</form> 

</body> 

</html> 

La figure 6-1 fournit une image du formulaire que vous venez de créer avec les repères 
correspondant au code XHTML. 
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Figure 6-1 

Formulaire type complet 



Fichier XHTiVIL ou PHP ? 

Le fichier peut être enregistré sans problème avec l'extension .litml ou .titm, car il ne contient aucun 
code PHP. C'est le fichier ci bl e . php, donné comme valeur de l'attribut acti on de l'élément <f orm>, qui 
traite les données du formulaire coté serveur. Il n'est pas gênant de l'enregistrer avec l'extension .php, 
même s'il ne contient aucun code PHP 



Récupération des données du formulaire 

Maintenant que vous savez créer de beaux formulaires, vous allez voir comment récupé- 
rer les données entrées par l'utilisateur dans les différents champs du formulaire. 

Tout d'abord, que se passe-t-il lorsque l'utilisateur clique sur le bouton d'envoi ? Une 
requête HTTP est envoyée au serveur à destination du script désigné par l'attribut action 
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de l'élément <form>. La requête contient toutes les associations entre les noms des 
champs et leur valeur. Ces associations se trouvent dans l'en-tête HTTP si la méthode 
POST est utilisée et dans l'URL s'il s'agit de la méthode GET. 



Valeurs uniques 

Les valeurs uniques proviennent des champs de formulaire dans lesquels l'utilisateur ne 
peut entrer qu'une valeur, un texte par exemple, ou ne peut faire qu'un seul choix (bouton 
radio, liste de sélection à choix unique). 

Depuis PHP 4.1, ces valeurs sont contenues sur le serveur dans des tableaux associatifs 
dits superglobaux appelés $„POST et $_GET, selon la méthode choisie. Les clés de ces 
tableaux sont les noms associés aux champs par l'attribut rame. 

Voyons tout de suite ce mécanisme à l'œuvre avec un formulaire élémentaire ne conte- 
nant qu'un seul champ de saisie de texte. Dans la suite de l'ouvrage, nous privilégions 
l'emploi de la méthode post pour l'envoi des formulaires. Dans ce chapitre, en revanche, 
nous envisageons la méthode get à titre informatif. 



W3C 

Le W3C, l'organisme de « normalisation » du Web, envisage de supprimer la valeur get pour l'attribut 
method des formulaires en HTML ou XHTML. 

Cas de la méthode POST 

Dans le code de l'exemple 6-2, l'élément <f orm> est écrit de la façon suivante (repère Q) ■ 

I action= $_SERVER["PHP_SELF"] ?> 

Cela désigne le script lui-même comme cible pour le traitement des données. 
Le code PHP proprement dit est le suivant (repère 0) : 
<?php 

if(isset($_POST["nom"]) && isset($_POST["niveau"] ) ) 
{ 

echo "<h2> Bonjour ". stripslashes($_POST["nom"]). " vous êtes ".$_POST["niveau"]. 

^" en PHP</h2>": 

} 

?> 

II contrôle d'abord l'existence des variables $_POST["nom"] et $_POST["niveau"], qui repré- 
sentent respectivement le texte saisi et la valeur associée à la case cochée de façon à 
n'afficher le message qu'après l'envoi des données (repère 0). Sans ces précautions, le 
message s'afficherait même en l'absence de saisie de données par le visiteur. Ces variables 
n'existent que si l'utilisateur a complété les champs et a cliqué sur le bouton d'envoi. 
Lorsqu'elles existent, elles sont utilisées pour créer un affichage de bienvenue, comme 
illustré à la figure 6-2. 
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La fonction stripslashesO est utilisée pour supprimer les caractères d'échappement 
ajoutés automatiquement devant les caractères spéciaux éventuellement utilisés dans les 
données saisies avant de les afficher dans la page. 

Exemple 6-2. Récupération des valeurs dans un formulaire élémentaire 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>Formulaire traité par PHP</title> 

</head> 

<body> 

<form action^ "<?= $_SERVER["PHP_SELF"] ?>" method="post" 
^ enctype="appl ication/x-www-form-urlencoded"> <— O 
<fieldset> 
<legend><b>Infos</b></legend> 
<div> 

Nom : <input type="text" name="nom" size="40" /> 
<br /> 

Débutant : <input type="radio" name="niveau" val ue="débLitant" /> 

Initié : <input type="radio" name="niveau" value="initié" /Xbr /> 

<input type="reset" val ue="Effacer" /> 

<input type="submit" val ue="Envoyer" /> 

</div> 

</fieldset> 

</form> 

<?php ^0 

if(isset($_POST["nom"]) && isset($_POST["niveau"] ) ) <— © 
( 

echo "<h2> Bonjour ". stripsl ashes($_POST["nom"] ) . " vous êtes ". 
^$_POST["niveau"]." en PHP</h2>": 

} 

?> 

</body> 
</html> 

Après avoir saisi « Jan Geelsen » dans le champ texte et coché la case « débutant », vous 
obtenez l'affichage illustré à la figure 6-2. Remarquez que les saisies ne sont plus visi- 
bles car la page a été entièrement réaffichée dans le navigateur ; pour conserver les 
données saisies dans le formulaire, consultez la section « Maintien de l'état du formu- 
laire » plus loin dans ce chapitre. 
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Figure 6-2 

Formulaire élémentaire et résultat 

Cas de la méthode GEJ 

Avec la méthode GET, vous récupérez les données du formulaire dans les variables $_GET 
["nom"] et $_GET["niveau"], comme ci-dessous : 

<?php 

if(isset($_GET["nom"]) && isset($_GET["niveau"])) 
{ 

echo "<h2> Bonjour ". stripslashes ($_GET["noin"]) . " vous êtes ".$_GET["niveau"]. 
^" en PHP</h2>"; 

} 

?> 

Contrairement à ce qui se passe avec la méthode POST, vous constatez que lors du clic sur 
le bouton d'envoi l'adresse de la page cible désignée par l'attribut action est suivie par le 
caractère ? puis par le nom de chaque champ et la valeur qui y est associée. 

Par exemple, si le nom de l'utilisateur est « Jean-René d'Orléans » et que la case « débu- 
tant » soit cochée, le navigateur affiche l'adresse complète : 

Ihttp://localhost/php5/C6form/form6.3_get.php?noni=Jean-Ren^E9+d%920rUE9ans&niveau 
^=initi^E9 

Les caractères accentués « é » et l'apostrophe sont codés en hexadécimal respectivement 
par XE9 et ^92. Les espaces sont remplacées par le signe +, et chaque paire nom^valeur est 
séparée par le signe &. 

Dans les versions antérieures à PHP 4.1, les données étaient récupérables dans les varia- 
bles $HTTP_POSTJARS OU $HTTP_GET„VARS OU encore directement dans des variables globales 
portant le nom des champs du formulaire (la valeur de leur attribut name), soit ici $nom et 
$niveau. Ces méthodes sont à considérer comme obsolètes. 
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Pour simplifier la manipulation des valeurs issues du formulaire, vous pouvez récupérer 
chaque valeur dans des variables scalaires dès le début du script de traitement, comme 
ci-dessous : 

I$sonnoin= $_POST["nom"] ; 
$sonniveaLi=$_POST["niveau"] ; 

puis les réutiliser sous cette forme par la suite. 
Maintien de l'état du formulaire 

Lorsque le script contenant le formulaire est chargé du traitement des données, l'ensem- 
ble de la page est réaffiché après traitement, de même que l'ensemble du formulaire. Le 
formulaire se retrouve alors dans son état initial, et toutes les saisies effectuées sont effa- 
cées (voir figure 6-2). 
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Figure 6-3 

Maintien de V état du formulaire 



En cas d'erreur de saisie sur un seul champ, l'utilisateur est obligé de recommencer 
l'ensemble de la saisie. S'il s'agit d'un long questionnaire, il y a de quoi s'impatienter. 
Pour éviter cela, il est utile de maintenir l'état du formulaire après traitement en réaffichant 
l'ensemble des saisies. Vous allez effectuer cette opération à partir du code de l'exemple 6-2 : 

• Pour la zone de saisie de texte dont l'attribut name a la valeur "nom", il suffit de définir 
l'attribut value avec la variable $_POST["nom"], non sans avoir au préalable contrôlé 
l'existence de cette variable. Lors du premier affichage de la page, la zone est donc 
vide ou contient le dernier nom saisi (repère O). Le code PHP est donc : 

I <?php if(isset($_POST["noni"])) echo $_POST["nom"]?> 

• Pour les boutons radio dont l'attribut name a la valeur "niveau" et qui permettent le 
choix entre les valeurs "Débutant" et "Initié", il faut définir l'attribut checked du 
bouton choisi à la valeur "checked" en fonction de la valeur de la variable $_POST 
["niveau"] (repère ©). Pour le premier bouton, le code PHP devient : 
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|<?php if Cisset($_POST["niveau"]) && $_POST["niveau"]=="clébutant") 
*»echo "checked=\"checkecl\"" ?> 

Après une saisie identique à celle de la figure 6-2, vous obtenez un écran identique à 
celui de la figure 6-3, dans lequel toutes les données saisies sont encore visibles après le 
traitement du formulaire. 

Exemple 6-3. Maintien de l'état du formulaire 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>Formulaire traité par PHP</title> 

</head> 

<body> 

<form action^ "<?= $_SERVER["PHP_SELF"] ?>" method="post" 
^enctype="appl ication/x-www-form-urlencoded"> 
<fieldset> 

<legend><b>Infos</b></legend> 

Nom : <input type="text" name="nom" size="40" value="<?php if(isset($_POST["nom"])) 
^echo $_POST["nom"]?>"/> •^O 
<br /> 

Débutant : <input type="radio" name="niveau" val ue="débutant" 

<?php if (isset($_POST["niveau"]) && $_POST["niveau"]=="débLitant" ) 

*»-echo "checked=\"checked\"" ?> /><— 0 

Initié : <input type="radio" name="niveau" value="initié" 

<?php if(isset($_POST["niveau"]) && $_POST["niveau"]=="initié") 

^•■echo "checked=\"checked\"" ?>/><br /> 

<input type="reset" val ue="Ef facer" /> 

<inpLit type="submit" val ue="Envoyer" /> 

</fieldset> 

</form> 

<?php 

if(isset($_POST["nom"]) && isset($_POST["niveau"])) 
{ 

echo "<h2> Bonjour ". stripslashes($_POST["nom"]) . " vous êtes " .$_POST["niveau"] . 
^" en PHP</h2>"; 

} 

?> 

</body> 
</html> 

Exemple pratique 

L'exemple 6-4 offre une illustration pratique d'utilisation de formulaire. Il s'agit d'un 
site d'annonces immobilières proposant un plan de financement aux visiteurs. 

L'application est constituée de deux fichiers, form4.html et form4.php. 
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Le fichier form4.html affiche le formulaire de saisie des données nécessaires au calcul du 
prêt (voir figure 6-4). Il ne contient aucun code PHP et peut donc être enregistré avec 
l'extension .html. L'attribut action de l'élément <form> (repère Q) désigne le fichier 
forrti4.php, qui est chargé du traitement des données et de l'affichage des résultats. 

Le fichier form4.php vérifie d'abord l'existence des variables $_POST["capital "], $_ 
POST["taux"] et $_POST["duree"], toutes nécessaires au calcul du prêt. La variable $_ 
POST["assur"] est nécessaire dans tous les cas. Elle a la valeur 1 puisque le bouton radio 
« OUI » est coché par défaut. $capital correspond au capital emprunté (repère 0). $taux 
désigne le taux mensuel sous forme décimale. Si l'utilisateur saisit 6 pour le taux annuel, 
la variable $taux vaut 6/100/12, soit 0,005, ou 0,5 % par mois (repère 0). $duree est la 
durée en mois (repère©). $assur renvoie au montant de l'assurance mensuelle, soit 
0,035 % du capital emprunté. Cette variable prend la valeur 0 si $_POST["assur"] vaut 0 
(repère 0). 

Vient ensuite le calcul de la mensualité selon la formule financière suivante (repère 0) : 
I $mens=($capital*$taux)/(l-pow( (l+$taux) ,-$duree) ) 

Le script affiche la mensualité hors assurance (repère 0) ainsi que le tableau d'amortis- 
sement contenant, entre autres, le capital restant dû et les intérêts de chaque période 
(repère 0). La figure 6-5 donne un exemple de résultat. 

Si le formulaire est incomplet, l'instruction header( )affiche à nouveau la page de saisie 
form4.html, obligeant l'utilisateur à effectuer une saisie complète (repère 0). 

'■^ Exemple 6-4. Calcul de prêt bancaire 

Page de saisie des données (fichier form4.html) : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<htnil xnilns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>Calcul de prêts</title> 

</head> 

<body> 

<h3>Prêts </h3> 

<form method="post" action="form4.php"> <— 0 
<fieldset> 

<legend>Les caractéristiques de votre prêt</legend> 

<table> 

<tr> 

<td>Montant</td> 

<td><input type="text" name="capital " /></td> 

</tr> 

<tr> 

<td>Taux</td> 
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<td><input type="text" nanie="taux" /></td> 

</tr> 

<tr> 

<td>Durée en année</td> 

<td><input type="text" name="duree" /></td> 

</tr> 

<tr> 

<td>Assurance</td> 

<td>OUI : <input type="radio" name="assur" checked="checked" value="l" />8inbsp: 

^NON<input type="radio" name="assur" value="0" /></td> 

</tr> 

<tr> 

<td><input type="reset" name="" val Lie="Ef facer"/></td> 

<td><input type="subinit" name="" val ue="Cal cul er"/></td> 

</tr> 

</table> 

</fieldset> 

</forin> 

</body> 

</html> 
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Figure 6-4 

Page principale de saisie des données 



Page de traitement des données et d'affichage des résultats (fichier form4.php) : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 
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<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<titl e>Tableau d' amorti ssement</ti tl e> 

</head> 

<body> 

<div> 

<?php 

if(isset($_POST["capital"])&&$_POST["taux"]&&$_POST["duree"]) 
{ 

$capital=$_POST[ "capital "]; <— © 

$taLix=$_P0ST["taux"]/100/12: <-© 

$duree=$_P0ST["duree"]*12; <-© 

$assur=$_POST["assur"]*$capital*0. 00035; <— 0 

$mens=($capi tal*$taux)/(l-pow( (l+$taux) ,-$duree) ) ; <— © 

echo "<h3>Pour un prêt de $capital Xeuro; à ", $_POST["taux"] sur ", 

^$_POST["duree"] , " ans la mensualité est de " , round($mens,2) . " 

^Seuro; hors assurance</h3>" ; <— © 

echo "<h4>Tableau d'amortissement du prêt</h4>": 

echo "<table border=\"l\"> <tr><th>Mois </th><th>Capital restant</ th><th> 
^Mensualité Hors Ass.</th><th>Amortissement </ th><th> Intérêt</th><th> 
^Assurance</th><th>Mensual ité Ass.cis </ th>":<— 0 
//Boucle d'affichage des lignes du tableau 
for($i=l :$i<=$duree;$i-H-) 
{ 

$int=$capital*$taux; 

$amort=$mens-$int: 

echo ''<tr>"; 

echo "<td>$i</td>": 

echo "<td>'' , round($capi tal ,2) . "</td>" ; 
echo "<td>'' , round($mens ,2) , "</td>" ; 
echo "<td>'' .round ($amort,2) , "</td>" ; 
echo "<td>" , round($int ,2) . "</td>" ; 
echo "<td>$assur</td>" ; 
echo "<td>" , round($mens+$assur ,2) , ''</td>'' ; 
echo "</tr>"; 
$capital=$capital -$amort; 

} 

echo ''</table>"; 

} 

el se 
{ 

header("Location:form4.php") ; <— © 

} 

?> 

</div> 

</body> 

</html> 
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Figure 6-5 

Page d'affichage des résultats 



Les valeurs multiples 

Certains champs de formulaire peuvent permettre aux visiteurs de saisir plusieurs valeurs 
sous un même nom de composant. 

Cela peut concerner un groupe de cases à cocher ayant le même attribut name, par exemple, 
dont il est possible de cocher une ou plusieurs cases simultanément. Ce peut également 
être le cas d'une liste de sélection ayant toujours un nom unique mais dans laquelle 
l'attribut multiple="multiple" est défini. Il est enfin possible de donner le même nom à 
des éléments de saisie de texte différents, mais cela présente moins d'intérêt. 

Dans tous les cas, ce n'est pas une valeur scalaire mais un tableau qui est récupéré côté 
serveur. Il faut pour cela faire suivre le nom du composant de crochets, comme pour créer 
une variable de type array. 

Dans l'exemple suivant : 

IBleu:<input type="checkbox" name="choix[]" value="bleu" /> 
Blanc:<input type="checkbox" name="choix[]" val ue="bl anc" /> 

l'utilisateur peut cocher les deux cases simultanément. Le programmeur récupère ces 
valeurs dans les variables suivantes : 

I$_POST["choix''][0] qui contient la valeur "bleu" 
$_POST["choix"][l] qui contient la valeur "blanc" 
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La variable $_POST est un tableau multidimensionnel, en l'occurrence à deux dimensions. 

L'exemple 6-5 illustre la méthode de récupération des valeurs multiples. Le formulaire 
créé par le fichier f orm5 . html contient trois zones de saisie de texte portant le même nom, 
une liste de sélection avec l'attribut mul ti pl e et quatre cases à cocher ayant le même nom. 
Dans les listes de sélection, l'utilisateur doit maintenir la touche Ctrl enfoncée pour faire 
plusieurs choix. Il peut être utile de lui rappeler cette fonctionnalité. 

L'objet du formulaire est de faire saisir une fiche de renseignements par l'utilisateur puis 
d'afficher l'ensemble de ces informations. Le script cible du formulaire contenu dans le 
fichier formB.php récupère les données et réalise une fiche récapitulative des renseigne- 
ments personnels si les variables du tableau $„POST existent (repère O) ou, dans le cas 
contraire, une boîte d'alerte, à l'aide de la fonction JavaScript alerte ) (repère ©), et une 
redirection vers la page de saisie, via la fonction JavaScript window.history.backO 
(repère ©). 

La figure 6-6 illustre le formulaire de saisie et la figure 6-7 un exemple de fiche de résultat. 

Exemple 6-5. Récupération des valeurs multiples 

Lefichierform5.html : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>Listes à choix multiples</title> 

</head> 

<body> 

<form method="post" action="form5.php" > 
<fieldset> 

<1 egend>Recherche d'emploi: complétez la fiche </legend> 
<div> 

<span>Nom<input type="text" name="ident[]" /> 
Prénom<input type="text" name="ident[]" /> 
Age<input type="text" name="ident[]" /> 
<br /Xbr /> 

Langues pratiquées<br /> 
<select name="l ang[]" multiple="multiple"> 
<option val ue="f rançai s"> f rançais</option> 
<option value="anglais"> anglais</option> 
<option value="allemand"> allemand</option> 
<option val ue="espagnol "> espagnol</option> 
</select><br /Xbr /> 
Compétences informatiques<br /> 

XHTML<input type="checkbox" name="competent[] " val ue="XHTML" /> 
PHP<input type="checkbox" name="competent[]" value="PHP" /> 
MySQL<input type="checkbox" name="competent[] " val ue="MySQL" /> 
ASP.Net<input type="checkbox" name="competent[]" value="ASP.Net" /> 
</span><br /Xbr /> 

<input type="reset" val Lie="EFFACER"/> 
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<input type="subniit" value="ENV0r7> 

</div> 

</fieldset> 

</form> 

</body> 

</html> 
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Formulaire de saisie 
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Le fichier f orm5 . php : 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset^i so-8859-1" /> 

<title>Compétences Info</title> 

</head> 

<body> 

<?php 

if(isset($_POST["ident"]) && isset($_POST["lang"]) && 

^isset($_POST["competent"])) <— Q 

{ 

echo "<table border=\"l\"><tr><th> Récapitulatif de votre fiche d'information 

^personnel 1 e</th></tr><tr><td>" ; 

$nom=$_POST["ident"][0]: 

$prenom=$_POST["ident"][l]; 

$age=$_POST["ident"][Z]; 

$lang = $_P0ST["1 ang"] ; 

$competent=$_POST[" compétent"] ; 

echo"Vous êtes :<b> Sprenom ", stripsl ashes($nom) ,"</b><br />Vous avez 
*»<b>$age ans </b> "; 
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echo "<br />Vous parlez :"; 
echo "<ul>"; 

foreach($lang as Svaleur) 
{ 

echo " <li> $valeur </li>": 

} 

echo "</ul>"; 

echo "Vous avez des compétences informatiques en :"; 
echo "<ul>"; 

foreach($competent as $valeur) 
{ 

echo "<li> Svaleur </li> "; 

) 

echo "</ul> </td></tr>"; 

} 

el se 
{ 

echo"<script type=\"text/javascript\">" ; 

echo "al ert( ' Cochez au moins une compétence! !');"; <—© 

echo "window. hi story .back( ) ; " : <— © 

echo "</script>"; 

} 

?> 

</body> 
</html> 
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Transfert de fichier vers le serveur 

L'inclusion d'un élément XHTML <input type="file" /> dans un formulaire crée une 
situation particulière. Il ne s'agit plus de transmettre une ou plusieurs valeurs scalaires au 
serveur mais l'intégralité d'un fichier, lequel peut avoir une taille importante et un type 
quelconque. Ce fichier doit évidemment être présent sur l'ordinateur du visiteur. 

Par rapport au transfert de données, le transfert de fichiers présente un problème de sécurité 
pour votre site puisque des fichiers vont être écrits et éventuellement exécutés sur le serveur. 

Supposez qu'un utilisateur mal intentionné transfère un fichier nommé index. php ou 
index.html sur le serveur. Ce fichier est exécuté automatiquement à l'appel de l'URL de 
votre nom de domaine. Pour éviter tout problème, il est prudent de prévoir une vérifica- 
tion de l'extension du fichier préalablement à la définition des extensions autorisées lors 
de la création du formulaire. 

Pour cette définition, vous utilisez l'attribut accept de l'élément <input />. Cet attribut 
peut prendre un grand nombre de valeurs, correspondant aux types MIME des fichiers 
acceptés, par exemple "image/gif", comme dans l'exemple 6-6, ou "text/html ". Un 
fichier d'un type différent est rejeté, ce qui confère une protection contre les utilisateurs 
mal intentionnés. 

Contrairement aux exemples précédents, l'élément <form> doit avoir l'attribut method à la 
valeur post et l'attribut enctype à la valeur nul ti part/form-data. 

Précaution supplémentaire, vous pouvez envisager de limiter la taille des fichiers à télé- 
charger en ajoutant au formulaire un champ caché nommé MAX_FILE_SIZE, dont l'attribut 
value contienne la taille maximale admise en octet. Cette valeur est récupérée dans la 
variable $_POST["MAX_FILE_SIZE"] (repère Q) lorsque le champ caché est défini par le 
code suivant (repère Q) ■ 

I <input type="hidden" name="MAX_FILE_SIZE" val ue="100000" /> 

L'utilisation de ce champ n'est pas obligatoire puisque le fichier php. i ni du serveur 
contient la directive "upl oad„max_f i 1 esi ze", dont la valeur est un entier indiquant la taille 
maximale en octet admise par défaut par le serveur. En local avec Wampserver, cette 
valeur est de 2 Mo. L'hébergeur peut toutefois définir une valeur très différente, qu'il 
vous appartient de vérifier à l'aide de la fonction phpinfo( ). 

L'ajout d'un bouton d'envoi à votre formulaire est bien sûr toujours indispensable. 

Lors de l'affichage de la page, l'utilisateur se retrouve face à ce qui ressemble à une zone 
de saisie de texte accompagnée d'un bouton dont l'intitulé est « Parcourir... ». Il peut saisir 
manuellement l'emplacement exact du fichier à transférer ou le choisir sur son disque en 
cliquant sur le bouton, comme il le ferait pour ouvrir un fichier à partir d'un traitement de 
texte, par exemple. Il n'est donc pas nécessaire de lui expliquer la procédure en détail. 

Une fois le fichier sélectionné, un clic sur le bouton Submit provoque l'envoi du fichier 
au serveur et son traitement par un script, que vous devez encore écrire. A ce moment, le 
fichier est bien transféré sur le serveur, mais il se trouve dans un répertoire tampon défini 
par la directive "upload_tmp_dir" du fichier php.ini. Si vous n'en faites rien, il est perdu 
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lors de la déconnexion du client. De plus, il est enregistré sous un nom différent de celui 
qu'il avait sur le poste client, et vous ne savez pas encore sous quel nom, puisque celui-ci 
est créé arbitrairement par le serveur. 

De même que pour le transfert de données simples, vous allez utiliser les tableaux super- 
globaux $_POST ou $_GET. Vous disposez également depuis la version PHP 4.1 du tableau 
associatif multidimensionnel $_FILES, qui contient les informations nécessaires au traite- 
ment du fichier transféré. 

Si, comme dans le code de l'exemple 6-6, le nom de l'élément <input type="file" . . /> 
est name="f ich", vous pouvez lire les valeurs suivantes : 

• $_FILES["fich"]["name"] : contient le nom qu'avait le fichier sur le poste client. 

• $_FILES["fich"]["type"] : contient le type MIME initial du fichier et permet un 
contrôle et une censure éventuelle du fichier transféré. 

• $_FILES["fich"]["size"] : donne la taille réelle en octet du fichier transféré. 

• $_FILES["fich"]["tmp_name"] : donne le nom temporaire que le serveur attribue auto- 
matiquement au fichier en l'enregistrant dans le répertoire tampon. 

• $_FILES["fich"]["error"] : donne le code d'erreur éventuel associé au fichier télé- 
chargé et permet d'afficher un message d'erreur en clair en créant un tableau indicé de 
0 à 4 contenant les messages appropriés. Ces codes sont définis par les constantes 
entières suivantes depuis PHP 4.3 : 

- UPLOAD_ERR_OK : de valeur 0, indique que le transfert est bien réalisé. 

- UPLOAD_ERR_INI_SIZE : de valeur 1, indique que la taille du fichier est supérieure à 
celle définie dans la php . i ni . 

- UPLOAD_ERR_FORM_SIZE : de valeur 2, indique que la taille est supérieure à celle définie 
dans le champ caché MAX_FILE_SIZE. 

- UPLOAD_ERR_PARTIAL : de valeur 3, indique que le fichier n'a été que partiellement 
téléchargé. 

- UPLOAD_ERR_NO_FI LE : de valeur 4, indique qu'aucun fichier n'a été téléchargé. 

En dernier lieu, vous devez procéder à l'enregistrement et au renommage éventuel du 
fichier sur le serveur. Vous disposez pour cela de la fonction move_uploacled_file(), dont 
la syntaxe est la suivante : 

I boolean move_upl oacled_f i 1 e( string "fichtmp", string "fichfinal ") 

"fichtmp" est le chemin d'accès du fichier temporaire et "fichfinal " le nom sous lequel 
sera enregistré définitivement le fichier. La fonction retourne TRUE si l'opération est bien 
réalisée et FALSE dans le cas contraire. 

Dans l'exemple 6-6, le code suivant (repère 0) : 

■ move_uploacled_file($_FILES["fich"]["tmp_name"],"imagephp.gif"); 

enregistre le fichier transféré désigné par $_FILES["fich"]["tmp_name"] dans le répertoire du 
fichier forme. 7. php du serveur sous le nom "1magephp.gif". Le fichier est alors pleinement 
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utilisable dans une page du site, comme si vous l'aviez transféré vous-même à l'aide d'un 
logiciel FTP. 

Si le transfert est bien réalisé, vous affichez un message de bonne fin (repère ©). En cas 
de problème de transmission ou de renommage du fichier, le script affiche le code de 
l'erreur générée à l'aide de la variable $_FILES["fich"]["error"] (repère 0). 

'•^ Exemple 6-6. Transfert de fichier 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-r' /> 

<title>Transfert de fichier</title> 

</head> 

<body> 

<form action="form6.php" method="post" enctype="multipart/form-data"> 
<fieldset> 

<input type="hidden" name="MAX_FILE_SIZE" val ue="10G000" /><-0 

<legend><b>Transfert de fichier</b></legend> 

<table> 

<tbody> 

<tr> 

<th>Fichier</th> 

<td> <input type="file" name="fich" accept="image/gif " size="50"/></td> 

</tr> 

<tr> 

<th>Clic!</th> 

<td> <input type="SLibmit" value="Envoi" /></td> 

</tr> 

</tbody> 

</table> 

</fieldset> 

</form> 

<!— Code PHP --> 
<?php 

if(isset($_FILES['fich'])) 
{ 

echo "Taille maximale autorisée : " ,$_POST["MAX_FILE_SIZE"] . 
^' octets<hr / >"; <-© 

echo "<b>Clés et valeurs du tableau \$_FILES </b><br />"; 
foreach($_FILES["fich"] as $cle => $valeur) 
{ 

echo "clé : $cle valeur : $valeur <br />"; 

} 

//Enregistrement et renommage du fichier 

$resul t=move_upl oaded_f ile($_FILES["f ich"]["tmp_name"] , "imagephp.gif" ) ; <— 0 
if($result==TRUE) 

(echo "<hr /><big>Le transfert est réalisé !</big>" ; ) <— 0 
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el se 

{echo "<hr /> Erreur de transfert n'",$_FILES["fich"]["error"]:) <— Q 

} 

?> 

</body> 
</html> 

La figure 6-8 illustre l'aspect de la page d'envoi des fichiers et la figure 6-9 celui de la 
page de confirmation affichant le résultat de l'opération de transfert et les clés et valeurs 
du tableau $_FILES. 
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Formulaire d'envoi de fichier 
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Page de confirmation du transfert 
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Transfert de plusieurs fichiers 

Il est possible de proposer à l'utilisateur de transférer plusieurs fichiers simultanément 
pour lui éviter de recommencer plusieurs fois la même opération à partir de l'exemple 
précédent. Vous devez en ce cas faire en sorte que les éléments <input type="file".../> 
soient tous écrits de la manière suivante : 

I <input type="file" nanie="fich[]"accept="image/gif " size="50"/> 

avec le même nom suivi de crochets (repères O et © de l'exemple 6-7) ; l'attribut accept 
peut prendre des valeurs différentes pour chaque élément <input />. 

La page de transfert correspondante est illustrée à la figure 6-10. 



3 Titnibret l du plubieuib nUiiers - Miuiusufl liilKiiit;! Explurei 




Fichier E&àon Affichage Favoris Outils ? 





O Précédente • O * IH | /^R«tiereher '^Favoris «S>Mèdia ^ S ' 

Adi esse 1^ hlltJi/jluLdll iiaI/ijI ip5/C6rij(iii/furiii6.8.^ip 



Choisissez les fichiers à transférer 

Tr;iTisrprts Hp pliisienrs fïrhiprs 
Fichier 1 ï^^^^^^^^^^^^^^^^^^^^^^^^^ | Parcourir... | 

Firhipr 2 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^J \ Parcourir... | 
Clic! I Envoi | 



Q OK Liens 



^ Terminé 



*^ Intranet local 



Figure 6-10 

Formulaire de transfert de plusieurs fichiers 



Vous récupérez les informations sur les fichiers transférés dans la tableau $_FI LES, devenu 
multidimensionnel à trois dimensions. 

Par exemple, la variable suivante : 

I $_FILES["fich"]["name"][0] 

permet de connaître le nom du premier fichier transféré. 

Vous pouvez lire les caractéristiques de chacun des fichiers transférés à l'aide des 
boucles f oreach imbriquées (repères Q et O). Ce code n'a toutefois d'intérêt que pour le 
programmeur lors des tests et est à supprimer dans un site réel. 

Vous procédez enfin au renommage et à la sauvegarde des fichiers transférés (repères 0 
et 0) puis au contrôle du bon déroulement de l'ensemble des opérations (repère Q). 
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<^ Exemple 6-7. Transfert simultané de plusieurs fichiers 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmUl.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<titl e>Transfert de plusieurs fichiers</title> 

</head> 

<body> 

<!-- Code HTML du formulaire --> 

<form action="<?= $_SERVER[ ' PHP_SELF' ] ?>" method="post" 

^enctype="mul tipart/form-data" > 

<fieldset> 

<input type="hidden" name="MAX_FILE_SIZE" value="100000" /> 

<1 egend><b>Transferts de plusieurs fichiers</b></legend> 

<table> 

<tbody> 

<tr> 

<th>Fichier l</th> 

<td> <input type="file" name="fich[]" accept="image/gif " size="50"/></td><— © 

</tr> 

<tr> 

<th>Fichier 2</th> 

<td> <input type="file" name="fich[]" accept="image/gif " size="50"/><— 0 

</td> 

</tr> 

<tr> 

<th>Clic!</th> 

<td> <input type="submit" val ue="Envoi " /></td> 

</tr> 

</tbody> 

</table> 

</fieldset> 

</form> 

<!— Code PHP — > 
<?php 

if(!empty($_FILES)) 
{ 

echo "Taille maximale autorisée : " ,$_POST["MAX_FILE_SIZE"] , " octets<hr / >"; 

foreach($_FILES["fich"] as $cle => $valeur) <-© 

{ 

echo "Clé : $cle <br />"; 
foreach($valeur as $key=>$val ) <— © 
{ 

echo " Fichier : $key valeur : $val <br />"; 

} 

} 

//Déplacement et renommage des fichiers 

$resul tl=move_upl oaded_f i 1 e($_FILES["f ich"] ["tmp_name"] [0] , "imagel .gif " ) ; <— 0 
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$result2=move_uploaded_file($_FILES["fich"]["tnip_name"][l] , "image2.gif") ; <— © 
if ($resultl==true && $resul t2==true) <— Q 
{echo "<br /> Transferts réalisés !<br />";} 
el se 

{echo "<br /> Transferts non effectués <br />";} 

} 

else echo "<h4>Choisissez les fichiers à transférer </h4>"; 
?> 

</body> 
</html> 

Les informations écrites par les boucles f oreach ont l'aspect suivant en cas de réussite des 
transferts : 



Taille maximale autorisée :100000 octets 
Clé : name 

Fichier : 0 valeur : figuregif.gif 

Fichier : 1 valeur : figuregif2.gif 
Clé : type 

Fichier : 0 valeur : image/gif 

Fichier : 1 valeur : image/gif 
Clé : tmp_name 

Fichier : 0 valeur : C:\D0CUME~2\PR0PRI~l\L0CALS~l\Temp\php2B8C.tmp 

Fichier : 1 valeur : C:\D0CUME~2\PR0PRI~l\L0CALS~l\Temp\php2B8D.tmp 
Clé : error 

Fichier : 0 valeur : 0 

Fichier : 1 valeur : 0 
Clé : size 

Fichier : 0 valeur : 24420 

Fichier : 1 valeur : 27614 

Transferts réalisés ! 



Gérer les boutons d'envoi multiples 

L'utilisation de plusieurs boutons submit dans un même formulaire permet de déclencher 
des actions différentes en fonction du bouton activé par l'utilisateur. Il est nécessaire pour 
cela que les boutons aient le même nom et que la sélection de l'action se fasse en fonc- 
tion de la valeur associée à chaque bouton via l'attribut val ue. 

L'exemple 6-8 crée une calculatrice en ligne proposant les opérations d'addition, de 
soustraction, de division et de puissance. Il est évidemment possible d'ajouter autant 
d'opérations que nécessaire. A chaque opération est associé un bouton submit (repères 
O, O, O et O) 

Deux zones de saisie de texte permettent d'entrer deux opérandes. Dans cet exemple, 
vous utilisez le maintien de l'état du formulaire de façon que ces derniers restent visibles 
lors de l'affichage du résultat (repères 0 et ©). 
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Le code PHP commence comme d'habitude par vérifier l'existence des variables conte- 
nues dans le tableau $_POST en fonction de la valeur contenue dans la variable $_POST 
["calcul"] de l'attribut value des boutons Submit. Selon l'opération désirée, une 
instruction switch effectue le calcul approprié, dont le résultat est contenu dans la 
variable $resultat. Cette valeur est affichée dans le champ de text nommé resuit 
(repère Q). 

Exemple 6-8. Une calculatrice en ligne 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

" http : //www . w3 . org/TR/xhtml ll/DTD/xhtml 11 . dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<title>Calculatrice en 1 igne</title> 

<meta http-equiv="Content-Type" content="text/html ; charset=IS0-8859-r' /> 
</head> 
<body> 

<!— Code PHP — > 
<?php 

if(isset($_P0ST["calcul"])&&isset($_P0ST["nbl"])&&isset($_P0ST["nb2"])) 
{ 

switch($_POST["calcul "]) 
{ 

case "Addition x+y": 

$resultat= $_P0ST["nbl"]+$_P0ST["nb2"] ; 

break; 

case "Soustraction x-y": 

$resultat= $_P0ST["nbl"]-$_P0ST["nb2"] ; 

break; 

case "Division x/y": 

$resultat= $_P0ST["nbl"]/$_P0ST["nb2"] ; 

break; 

case "Pui ssance x"y" : 

$resultat= pow($_POST["nbl"] .$_P0ST["nb2"]) ; 
break; 

} 
} 

el se 
( 

echo "<h3>Entrez deux nombres : </h3>"; 

) 

?> 

<!-- Code HTML du formulaire --> 

<form action="<?=$_SERVER['PHP_SELF']?>" method="post" > 
<fieldset> 

<legend><b>Calculatrice en ligne</b></legend> 

<table> 

<tbody> 

<tr> 

<th>Nombre X</th> 
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name="nb2" value="<?php if(isset($_P0ST["nb2"])) 
se echo" ?>"/> <— © 



<td> <input type="text" name="nbl" value="<?php if(isset($_POST["nbl"])) 
*»echo $_POST['nbl']:else echo" ?>'7><-0 
</td> 
</tr> 
<tr> 

<th>Nombre Y</th> 
<td> <input type="text 
*»echo $_P0ST['nb2']:e 
</td> 
</tr> 
<tr> 

<th>Résultat </th> 

<td> <input type="text" name="result" value="<?php if(isset($resultat) 
^echo $resultat;else echo"?>"/>^0 
</td> 
</tr> 
<tr> 

<th>Choisissez!</th> 
<td> 

<input type="subinit" naine="cal cul ' 
<input type="submit" naine="cal cul ' 
<input type="submit" naine="cal cul' 
<input type^'submit" naine="cal cul' 
</td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 
</body> 
</html> 

La figure 6-11 illustre une page de résultat pour la fonction Puissance. 



value="Addition x+y" /><— O 
value=''Soustraction x-y" /><— 0 
value="Division x/y" 
value="Puissance x^y 



■ />^0 
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Calculatrice en Keite 



Numbre 1 5 



Nombre 2 13 



Résultat 1220703125 



Choisissez! [ AJdiliutix-^y 1 1 Suuslr ouliuf i x-y 1 1 Divisiuti | [ PuiasduiuK x^y ~ 



S le 



Intranet local 



Figure 6-1 1 

Une calculatrice en ligne 
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Exercices 

Exercice 1 

Créez un formulaire comprenant un groupe de champs ayant pour titre "Adresse cl ient". 
Le groupe doit permettre la saisie du nom, du prénom, de l'adresse, de la ville et du code 
postal. Les données sont ensuite traitées par un fichier PHP séparé récupérant les 
données et les affichant dans un tableau XHTML. 

Exercice 2 

Améliorez le script précédent en vérifiant l'existence des données et en affichant une 
boîte d'alerte JavaScript si l'une des données est manquante. 

Exercice 3 

Le fichier suivant peut-il être enregistré avec l'extension .php ou .html ? Où se fait le 
traitement des données ? 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<title> Insertion des données </title> 

</head> 

<body> 

<form method="post" action="ajoLit.php" > 

//Suite du formulaire 

</form> 

</body> 

</html> 

Exercice 4 

Comment faire en sorte que les données soient traitées par le même fichier que celui qui 
contient le formulaire ? Proposez deux solutions. 

Exercice 5 

Créez un formulaire de saisie d'adresse e-mail contenant un champ caché destiné à récu- 
pérer le type du navigateur de l'utilisateur. Le code PHP affiche l'adresse et le nom du 
navigateur dans la même page après vérification de l'existence des données. 

Exercice 6 

Créez un formulaire demandant la saisie d'un prix HT et d'un taux de TVA. Le script 
affiche le montant de la TVA et le prix TTC dans deux zones de texte créées dynamique- 
ment. Le formulaire maintient les données saisies. 

Exercice 7 

Créez un formulaire n'effectuant que le transfert de fichiers ZIP et d'une taille limitée à 
1 Mo. Le script affiche le nom du fichier du poste client ainsi que la taille du fichier 
transféré et la confirmation de réception. 
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Exercice 8 

Dans la perspective de création d'un site d'agence immobilière, créez un formulaire 
comprenant trois boutons Submit nommés Vendre, Acheter et Louer. En fonction du 
choix effectué par le visiteur, redirigez-le vers une page spécialisée dont le contenu 
réponde au critère choisi. 
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Une fonction est un bloc de code qui n'est pas exécuté de manière linéaire dans un script. 
Ce code ne le sera que lors de l'appel explicite de la fonction. Écrit une seule fois, ce code 
peut être exécuté aussi souvent que nécessaire. Cela allège d'autant l'ensemble du code. 

Les fonctions natives de PHP 

PHP propose en standard une multitude de fonctions natives écrites en langage C, ainsi que 
quantité de modules d'extension qu'il est possible d'associer à la distribution standard. 
Les modules sont tous décrits dans la documentation officielle, et il est recommandé 
d'utiliser les fonctions qu'ils contiennent plutôt que de les réinventer vous-même. 

Avant d'utiliser un module, il convient de vérifier qu'il est bien installé sur le serveur de 
votre hébergeur. On recense aujourd'hui une bonne centaine d'extensions. Or je ne 
connais personnellement aucun hébergeur qui en ait installé ne serait-ce que la moitié, 
loin s'en faut. Pour vérifier la disponibilité d'un module, vous disposez de la fonction 
get_loaded_extensions( ), qui retourne un tableau contenant les noms de tous les modules 
d'extension installés sur le serveur. 

En écrivant le script suivant, vous obtenez la liste des modules classée par ordre alphabé- 
tique puis affichée à l'aide d'une boucle foreach : 

<?php 

$tabext = get_l oaded_extensions( ) ; 
natcasesort($tabext) ; 
foreach($tabext as $cle=>$valeur) 
{ 

echo "  $valeur 

} 

?> 
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Avec le serveur local Wampserver 2.0, vous obtenez la liste suivante : 



apache2handl er 


bcmath 


cal endar 


com_dotnet 


ctype 


date 


dom 


filter 


ftp 


gd 


hash 


iconv 


json 


1 i bxml 


mbstring 


mysql 


mysql i 


odbc 


pcre 


PDO 


pdojysql 


Refl ection 


session 


SimpleXML 


SPL 


SQLite 


standard 


tokenizer 


wddx 


xmlxml reader 


xmlwriter 


zlib 








et sur le serveur PHP 5 de l'hébergeur OVH : 


bcmath 


cal endar 


cgi 


ctype 


curl 


date 


dba 


dbase 


dom 


exif 


filter 


ftp 


gd 


gettext 


gmp 


hash 




i conv 


imap 


json 


1 i bxml 


mbstring 


mcrypt 


mhash 


ming 


mysql 


mysql i 


openssl 


pcre 


pdf 


PDO pdojysql 


pdo_sql ite 


pgsql 


posix 


pspel 1 


Ref 1 ection 


session 


SimpleXML 


soap 


sockets 


SPL 


SQLite 


standard 


sysvsem 


sysvshm 


tokenizer 


wddx 


xml 


xml reader 


xml rpc 


xmlwriter 


xsl 


Zip 


zlib 





Soit pas moins de 54 extensions ! 

Vous constatez qu'il existe peu d'extensions communes entre le serveur local installé 
avec Wampserver 2.0 et un serveur distant susceptible d'héberger votre site. 

Pour chaque module, il est possible de lister l'ensemble des fonctions disponibles. Cela 
n'est toutefois guère utile, car même si une fonction fait partie d'un module, votre héber- 
geur peut très bien l'avoir désactivée, notamment pour des raisons de sécurité ou d'abus 
d'occupation du serveur. La fonction mai 1 ( ) d'envoi de courrier, par exemple, est souvent 
désactivée chez les hébergeurs, en particulier les gratuits. 

Pour obtenir la liste des fonctions d'un module, vous disposez de la fonction suivante : 
I array get_extensions_funcs("nom_module") 

Cette fonction retourne un tableau indicé, dont les valeurs sont les noms des fonctions de 
chaque module. 

Par curiosité, exécutez le petit script de l'exemple 7-1 sur votre serveur distant pour véri- 
fier la liste, classée par ordre alphabétique, des modules et des fonctions que vous pouvez 
utiliser. Quoi de plus frustrant, en effet, que d'écrire de superbes scripts alors que les fonc- 
tions correspondantes sont disponibles sur le serveur local mais pas sur le serveur distant. 

Exemple 7-1 . Liste des modules et des fonctions affichées sur le serveur 
distant 

|<?php 
//Tableau contenant le nom des extensions 
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$tabext = get_l oaded_extensions( ) ; 
natcasesort($tabext) ;//tri par ordre alphabétique 
//Lecture des extensions 
foreach($tabext as $cle=>$valeur) 
{ 

echo "<h3>Extension  $val eur </h3> "; 
//Tableau contenant le nom des fonctions 
$fonct = get_extension_funcs($valeur); 
//Tri alphabétique des noms de fonction 
sort($fonct) ; 

//Lecture et affichage du nom des fonctions des extensions 

for($i=0:$i<count($fonct) :$i++) 

{ 

echo $fonct[$i ] , "  &nbsp: \n"; 
echo "<hr />"; 

} 

} 

?> 

La figure 7-1 illustre la liste impressionnante de fonctions que vous obtenez. Par simple 
copier-coller, vous obtenez à bon marché un mémo des fonctions utilisables sur votre 
serveur. 

Pour vérifier la disponibilité d'une fonction native de PHP ou d'une fonction personna- 
lisée, vous pouvez tester sa présence à l'aide de la fonction function_exists("nom_ 
fonction"), qui renvoie la valeur TRUE si la fonction passée en paramètre existe et FALSE 
dans le cas contraire. 

Pour vérifier, par exemple, que la fonction mysql_pconnect( ) est utilisable, vous pouvez 
écrire : 

if (f unction_exists( 'mysql_pconnect ' ) ) 
{ 

echo "La fonction est utilisable. <br />"; 

} 



Créer ses propres fonctions 

Malgré les quelques deux mille fonctions contenues dans l'ensemble des modules exis- 
tants à ce jour, il arrive, faute de fonction disponible, de devoir effectuer plusieurs fois le 
même traitement dans un script. Heureusement, il est possible de créer des fonctions 
personnalisées, qui permettent tout à la fois de gagner du temps de saisie et d'alléger 
votre script en ne répétant pas plusieurs fois un même code. 

Au fur et à mesure de l'écriture de vos scripts, vous pouvez de la sorte réutiliser du code 
déjà écrit dans un script précédent. Il vous faut pour cela identifier, dès la conception du 
ou des sites que vous souhaitez réaliser, les tâches susceptibles de se retrouver dans 
d'autres situations et qui ne sont pas prises en compte par une fonction existante de PHP. 
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Figure 7-1 

Lwfe des fonctions disponibles sur le serveur de l'hébergeur ovh 

Ces fonctions personnalisées doivent être écrites dans un ou des scripts séparés, qu'il vous 
suffit ensuite d'inclure dans de nouveaux scripts au moyen d'une instruction irclude( ) ou 
requi re( ). 

Définir une fonction 

En règle générale, une fonction peut être définie n'importe où dans un script, y compris 
après avoir été utilisée. Il existe cependant des exceptions, rares, comme nous le verrons 
dans la section « Cas particuliers » en fin de chapitre. 

La procédure de déclaration d'une fonction doit suivre les règles de syntaxe suivantes : 

• Commencez par définir l'en-tête de la fonction à l'aide du mot-clé function suivi du 
nom de la fonction et de parenthèses. Les noms de fonctions suivent les règles énoncées 
pour les variables : caractères alphabétiques et signe « _ » pour le premier caractère 
puis caractères alphanumériques pour la suite. Il est déconseillé de commencer un nom 
de fonction par deux caractères de soulignement, car cette convention est réservée 
pour définir des fonctions natives de PHP 5. La redéfinition de fonction étant interdite 
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dans PHP, contrairement à ce qui se fait dans d'autres langages, il est interdit de créer 
une fonction dont le nom soit identique à une fonction existante dans un des modules 
installés. En contrevenant à cette règle, vous vous exposez à une erreur fatale et au 
méchant message suivant, qui met fin au script : 

I "Fatal error: Cannot redeclare dateO in c:\eyrolles\php5\fonctions\fonction2.php 
^on line 3" 

Dans cet exemple, vous souhaitez définir une fonction nommée dateO au lieu de 
1 adate( ), comme à l'exemple 7-2, alors qu'il existe déjà une fonction portant ce nom 
dans le module standard. 

• Les parenthèses qui suivent le nom de la fonction peuvent contenir différents noms de 
variables comme paramètres de la fonction. Les noms des paramètres n'ont aucune 
importance en soi, et vous pouvez même leur donner des noms qui existent déjà dans 
le script, quoique ce ne soit pas conseillé. L'utilisation des paramètres n'est pas obli- 
gatoire. 

• Ouvrez un bloc de code limité par des accolades contenant l'ensemble du code de 
définition de la fonction. Cette partie, qui constitue le corps de la fonction, peut conte- 
nir toutes les instructions de PHP ainsi que n'importe quelle fonction native. 

• Si la fonction doit retourner une valeur, ce qui n'est pas obligatoire, il faut faire précé- 
der la variable ou l'expression qui contient cette valeur du mot-clé return. 

Vous obtenez la structure générale suivante : 

function mafonction($x,$y . . . . ) 
{ 

//code de définition de la fonction 
return $var; 

} 

Pour appeler la fonction, vous écrivez : 

I mafonction($a.$b ) 

ou encore : 

I mafonction(4,5, . . . ) 

Les paramètres peuvent être ici indifféremment des scalaires ou des variables. Il importe 
dans les deux cas de donner à la fonction autant de paramètres que dans sa déclaration, 
sauf si vous avez défini des paramètres par défaut (voir plus loin). 

La position de la déclaration d'une fonction dans le script n'a pas d'importance depuis 
PHP 4. Vous pouvez ainsi appeler une fonction au début du script alors qu'elle n'est défi- 
nie qu'en fin de script. Il est toutefois préférable de définir les fonctions en début de 
script, comme dans PHP 3, car cela améliore la présentation et la lisibilité du code. 

Pour les fonctions définies dans des scripts séparés, il est préférable de les inclure dès le 
début du script qui les utilise, et ce au moyen de l'instruction incl ude( ) ou requi re( ). 
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Les fonctions qui ne retournent pas de valeur 

Dans l'exemple 7-2, vous créez deux fonctions qui ne retournent pas de valeur. La 
première, 1 aclate( ), crée un affichage de la date et de l'heure sans aucun paramètre, et la 
seconde 1 adate2( ), y ajoute un message qui est passé en paramètre unique. 

Ces deux fonctions créent un affichage dans une cellule de tableau XHTML munie d'un 
style particulier, qui peut être le même dans toutes les pages du même site. 



Pour en savoir plus 

Pour plus de détails sur la syntaxe de la fonction date( ) utilisée dans le script, reportez-vous au chapi- 
tre 8. 



Lors des appels de ces fonctions, les trois premiers appels fonctionnent sans problème. 
En revanche, l'appel de la fonction ladate2() sans paramètre, alors même que sa 
définition en comporte un, provoque un avertissement, ou "warning", mais sans mettre fin 
pour autant au script, à la différence d'une erreur fatale. Pour éviter ce genre de 
problème, vous pouvez faire précéder, lors de son appel, le nom de la fonction par le 
caractère @, qui empêche l'apparition du message d'alerte. 

La figure 7-2 illustre le résultat de ces différents appels. 
'•^ Exemple 7-2. Fonctions ne retournant pas de valeur 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>Fonctions ne retournant pas de valeurs</title> 

</head> 

<body> 
<div> 

<?php 

//Fonction sans argument 

function ladateO 

{ 

echo "<table XtrXtd style=\"background-color:blue;color:yellow: 
^border-widthilOpx; border-style:groove;border-color:#FFCC66;font-style:fantasy ; 
^font-size:30px\"> "; 

echo date("\l\e d/m/Y \i\l \e\s\\t H:i:s"); 
echo "</td></tr></table><hr />"; 

} 

//Fonction avec un argument 

function ladate2($a) 

{ 
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echo "<tabl eXtrXtd style=\"background-color:bl ue:color:yel lowiborder-widthilOpx; 
^border-style:groove;border-color:#FFCC66;font-style:fantasy : font-size:30px\">" ; 
echo "$a ",date("\l\e d/m/Y \i\l \e\s\\t H:i:s"): 
echo "</td></tr></table><hr />": 

} 

//Appels des fonctions 
echo 1 adate( ) ; 
echo 1 adate2( "Bonjour" ) ; 
echo 1 adate2( "Sal ut" ) ; 

echo ladate2();//provoque un avertissement (Warning) 

echo @1 adate2( ) ;//empêche l'apparition du message d'avertissement 

?> 

</div> 

</body> 

</html> 



^ ronction^ ne retournant p3S ill' i llfiir Ml 1 1 illil I II l' Il m ^MjjjB^B^^^^^^^^^^^^^B^B 

fichier EdiboQ Affichage Histonquc Marque pages Outils ? 

C /N <îî — hItt)://www.funhtml.com/php5/C7fonctk>ns/fonctk>r\2.php 



■M^.lQuickSoit P| 



le 13/10/2008 il est 18:39:31' 



Bonjour le 13/10/2008 il est 18:39:31 



Salut le 13/10/2008 il est 18:39:31' 



Waraiog: N&SDig argument I for ladatc^O, caDcd m h<m)cz-60iuafatmln'wn''plç5 C7foactkiii&'f[»^^ 
anH (iffÎTif'd ni hnmp/ 60 fiinhmil min php5 f 'fnnrrinn^/fonctionl.php on Hn** 21 



le 13/10/2008 il est 18:39:31 



le 13/10/2008 il est 18:39:3 il 



Figure 7-2 

Fonctions d'affichage de la date 



Vous avez vu en détail au chapitre 5 la manière de lire l'intégralité d'un tableau. Si vous 
utilisez souvent ce tableau, vous avez tout intérêt à créer une fonction de lecture du 
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tableau et d'affichage de leurs éléments sous la forme d'un tableau XHTML à deux 
colonnes par exemple. 

Cet exemple peut être réutilisé ou adapté pour afficher les résultats de l'interrogation 
d'une base de données, lorsque les résultats sont récupérés sous forme de tableau, ce qui 
est souvent le cas. C'est l'objet de l'exemple 7-3, qui lit un tableau unidimensionnel. 

Les paramètres de la fonction sont, dans l'ordre, le nom du tableau, la largeur de la 
bordure des cellules XHTML et les libellés des colonnes. Le corps de la fonction est 
essentiellement composé d'une boucle chargée de lire les clés et les valeurs des éléments 
du tableau et ne présente pas de difficultés. Comme la première, cette fonction ne retourne 
pas de valeur mais crée un affichage XHTML. 

La figure 7-3 donne un exemple du résultat obtenu pour des tableaux de données. 
'•^ Exemple 7.3. Fonction de lecture de tableaux 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; =iso-8859-l" /> 

<title>Fonction de lecture de tableaux</title> 

</head> 

<body> 
<div> 

<?php 

//Définition de la fonction 

function tabuni ($tab,$bord,$libl,$l ib2) 

{ 

echo "<table border=\"$bord\" width=\"100%\"><tbody><tr><th>$libl</th> 
'•<th>$lib2 </th></tr>": 
foreach($tab as $cle=>$valeur) 
{ 

echo "<tr><td>$cle</td> <td>$valeur </td></tr>": 

} 

echo "</tbody> </table><br />"; 

} 

//Définition des tableaux 

$tabl = array( "France"=>"Pari s" , "Al 1 emagne"=>"Berl in" , "Espagne"=>"Madrid" ) ; 

$tab2 = array( "Poisson "=>" Requin" , "Cétacé"=>" Dauphin" , "Oi seau"=>"Aigl e" ) ; 

//Appels de la fonction 

tabuni ($tabl ,1 , "Pays" . "Capi tal e" ) ; 

tabuni ($tab2,6, "Genre" , "Espèce" ) ; 

?> 

</div> 

</body> 

</html> 
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Figure 7-3 

Affichages réalisés par la fonction tabuni() 



Les fonctions qui retournent une valeur 

Au sens mathématique du terme, une fonction se doit de retourner une valeur calculée à 
partir des paramètres qui lui sont passés. Vous allez illustrer cette possibilité en créant 
une fonction qui calcule et retourne la mensualité à payer pour un prêt en fonction du 
capital emprunté, du taux d'intérêt et de la durée du prêt. 

Ce type de fonction financière se retrouve couramment, dans Excel par exemple. En 
revanche, elle n'existe pas nativement dans PHP ni dans aucun module additionnel. Sa 
définition nécessite quelques commentaires pour en comprendre l'écriture. 

La formule de calcul d'une mensualité M est la suivante : 

M = (CxD/[l-(l + D-"] 
C est le capital emprunté, désigné par le paramètre $capi tal . 

T est le taux mensuel sous forme de nombre décimal — tel que ne nous l'indique jamais 
notre banquier, qui préfère nous donner un taux annuel. Ce paramètre annuel est passé à 
la fonction et désigné par la variable $tauxann. n est la durée en nombre de mois. Le para- 
mètre correspondant fourni à la fonction est exprimé en années au moyen du paramètre 
$dureeann puis est converti en mois. Le quatrième paramètre de la fonction, $assur, 
permet de calculer le montant de l'assurance. Il vaut 1 si le client désire s'assurer et 0 
dans le cas contraire. 
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La fonction commence par adapter les données bancaires usuelles à la formule du calcul 
financier. Le taux annuel, par exemple, est converti en taux mensuel décimal. Par exemple, 
5 % l'an devient 5/100/12, soit 0.00416666. La fonction calcule ensuite la mensualité au 
moyen de la formule ci-dessus puis retourne cette valeur arrondie au centime près à l'aide 
de la fonction round( ). 

Le script de l'exemple 7-4 s'achève par l'utilisation de cette fonction avec des paramètres 
scalaires puis avec des variables. 

'•^ Exemple 7-4. Fonction de calcul de prêt 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>CALCUL DE PRETS</ti tl e> 

</head> 

<body> 

<?php 

function mensual ite($capital , $tauxann, $dureeann,$assur) 
{ 

//calcul du taux mensuel décimal 
$tauxmensuel =$tauxann/100/12; 
//calcul de la durée en mois 
$duree=$dureeann*12; 

//calcul de l'assurance soit 0.035% du capital par mois 
$ass=$assur*$capital*0.00035;//vaut 0 si $assur vaut 0 

//calcul de la mensualité 

$mens=($capi tal*$tauxmensuel )/(l-pow( ( l+$tauxmensuel ) .-$duree) ) + 
^$ass: 

return round($mens,2) ; 

} 

$mens = mensual itedOOOO, 5,3,1) ; 

echo "<h3>Pour un prêt de 10000 n à 5% l'an sur 3 ans, la mensualité est de ", 

*»$mens ," n assurance compri se</h3>" ; 

// 

$cap=80000;$taux=3.5:$duree=10; 

$mens = mensual ite($cap,$taux.$duree,0) ; 

echo "<h3>Pour un prêt de $cap n à $taux% l'an sur $duree ans, la mensualité est 

**de ".$mens ," n sans assurance </h3>": 

?> 

</body> 
</html> 

Le script retourne le résultat suivant : 



Pour un prêt de 10000 a à S% l'an sur 3 ans, la mensualité est de 303.21 n assurance 
compri se 

Pour un prêt de 80000 n à 3.5^ l'an sur 10 ans, la mensualité est de 791.09 n sans 
assurance 
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Au chapitre 6, vous avez déjà réalisé un formulaire de saisie de données pour un calcul de 
prêt. La fonction que vous venez de créer peut être incorporée à ce script pour rendre 
l'ensemble plus élégant. 

Retourner plusieurs valeurs 

PHP n'offre pas la possibilité de retourner explicitement plusieurs variables à l'aide d'une 
syntaxe du type : 

I return $a,$b,$c 

Pour pallier cet inconvénient, il suffit de retourner une variable de type array contenant 
autant de valeurs que désiré. Vous pourriez aussi envisager de retourner un objet doté de 
plusieurs propriétés, mais il serait quelque peu fastidieux de créer une classe et des objets 
spécialement pour la circonstance si la création d'objets ne faisait pas partie de la 
conception générale du script. 

L'exemple 7-5 illustre le retour de plusieurs valeurs par le biais de la création d'une 
fonction appliquée à un nombre complexe qui retourne à la fois le module et l'argument 
du nombre. 



Rappel 

Un nombre complexe s'écrit a + \b, avec = - 1 . Son module est égal à la racine carrée de (a^ + b^). Son 
argument est l'angle (Ox,OM) en radian si le point M a pour coordonnées (a,b). 

La fonction modarg( ) reçoit comme paramètres les nombres a et b passés dans les variables $reel et 
$i ma g et retourne un tableau associatif dont les clés sont les chaînes "module" et "argument" avec les 
valeurs associées correspondantes. 



Exemple 7-5. Fonction de calcul sur des nombres complexes 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<titl e>Nombres compl exes</ti tle> 

</head> 

<body> 

<div> 

<?php 

function modarg($reel ,$imag) 
{ 

//$mod= hypot($reel .$imag) : 

//ou encore si vous n'avez pas la fonction hypotOdu module standard 

$mod =sqrt($reel*$reel + $imag*$imag) ; 

$arg = atan2($imag,$reel ) ; 

return array( "modul e"=>$mod, "argument"=>$arg) ; 

} 
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//Appels de la fonction 
$a= 5; 
$b= 8; 

$coniplex= modarg($a,$b): 

echo "<b>Nombre complexe $a + $b i:</b><br /> module = ", $complex["module"], 

^"<br />argument = " ,$compl ex["argument"] , " radians<br />"; 

?> 

</div> 

</body> 
</html> 

Le script retourne le résultat suivant : 



Nombre complexe 5+8 i: 
module = 9.4339811320566 
argument = 1.0121970114513 radians 



Grâce à l'artifice consistant à retourner un tableau de valeurs, vous pouvez créer des 
fonctions qui retournent autant de valeurs que désiré. Vous utiliserez cette dernière 
méthode systématiquement pour retourner plusieurs valeurs. 

Les paramètres par défaut 

Il n'est pas rare dans l'écriture de code XHTML de ne pas définir certaines valeurs 
d'attributs d'un élément donné car vous savez qu'il prendra automatiquement une valeur 
par défaut. 

Par exemple, le formulaire écrit de la façon suivante : 
I <form action="machin.php"> 
est l'équivalent de celui-ci : 

I <form action="machin.php" method="get" enctype="application/x-www-form-url-encoded"> 

Les attributs method et enctype ayant les valeurs par défaut ci-dessus il n'est pas néces- 
saire de les préciser si ces valeurs vous conviennent. 

Lorsque vous créez une fonction personnalisée, vous pouvez procéder de même et 
donner des valeurs par défaut aux paramètres de la fonction. Il suffit pour cela d'affecter 
une valeur au paramètre dans la définition de la fonction (repère Q de l'exemple 7-6). 

Si vous ne donnez pas de valeur à ces paramètres lors de l'appel de la fonction, ils auront 
automatiquement la valeur définie dans la déclaration de la fonction (repère 0). 

L'exemple 7-6 illustre la définition d'une fonction élémentaire qui retourne un prix hors 
taxes en utilisant comme paramètres le prix TTC et le taux de TVA. 

En réalisant les appels : 



I echo ht(154,19.6) 
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ou : 

I echo ht(154) 

vous obtenez le même résultat, à savoir 123.82, le paramètre $tax désignant le taux de 
TVA valant 19.6 par défaut. 

En revanche, l'appel suivant : 

I echo ht(154. 5.5) 

retourne la valeur 145.53 car le paramètre $tax est défini explicitement à la valeur 5.5. 
'•^ Exemple 7-6. Fonction avec une valeur par défaut 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtcl"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" CDntent="text/html ; charset=i so-8859-r' /> 

<title>Fonction avec une valeur de paramètre par défaut</title> 

</head> 

<body> 

<div> 

<?php 

function ht($prix,$tax=19.6) <— O 
{ 

return "Prix Hors Taxes :". round($prix*(l-$tax/100) ,2) ; 

} 

$prix=154; 

echo "Prix TTC= $prix € ",ht($prix)," &euro:<br />":<—© 
echo "Prix TTC= Sprix € " ,ht($prix,19.6) ," €<br />"; 
echo "Prix TTC= $prix € " ,ht($prix,5. 5) , " &euro:<br />"; 
?> 

</div> 

</body> 

</html> 



Attention 

Dans la définition d'une fonction, tous les paramètres qui ont une valeur par défaut doivent figurer en 
dernier dans la liste des variables. 

La fonction ht( ) de l'exemple 7-6 peut être appelée en omettant le deuxième paramètre avec ht (154). 
En revanche, si vous la définissez par le biais de : 

function ht($tax=19.6,$prix) { } 

et que vous tentiez de l'appeler à l'aide du code ht( ,154) ou ht(154), elle ne fonctionne pas, le 
premier code provoquant une erreur fatale et un arrêt du script et le second un avertissement indiquant 
qu'il manque un argument. 
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Les fonctions avec un nombre de paramètres variable 

Dans les définitions précédentes de fonctions, vous aviez l'obligation de définir claire- 
ment le nombre de paramètres utilisés par la fonction. Cela pose un problème si le nombre 
de paramètres n'est pas connu à l'avance. Il existe heureusement plusieurs méthodes, 
adaptées à différentes circonstances, pour créer des fonctions acceptant un nombre variable 
de paramètres. 

Les paramètres de type array 

En passant un tableau comme paramètre à une fonction, cette dernière n'a en apparence 
qu'un seul paramètre. Ce sont en fait les éléments du tableau qui sont utilisés et traités 
par la fonction, chacun devenant comme un paramètre particulier. C'est donc dans le 
corps de la fonction que vous pourrez déterminer le nombre d'éléments du tableau et 
utiliser cet ensemble de valeurs, qui seront lues à l'aide d'une boucle. 

La fonction créée à l'exemple 7-7 réalise le produit de nombres qui lui sont passés en 
tant qu'éléments du tableau $tab, affiche le nombre de paramètres et retourne leur 
produit. Elle peut, par exemple, servir au calcul de la factorielle d'un entier sans pour 
autant être récursive, pour peu que le tableau contienne une suite de nombres créée au 
moyen de la fonction range( ). 

'•^ Exemple 7-7. Produit des éléments d'un tableau 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>Nombre de paramètres variable</title> 

</head> 

<body> 

<div> 

<?php 

function prod($tab) 
{ 

$n=count($tab) ; 

echo "Il y a $n paramètres :"; 
$prod = 1: 

foreach($tab as $val ) 
{ 

echo "$val , " ; 
$prod *=$val ; 

) 

echo " le produit vaut "; 
return $prod; 

} 
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Stable ranged.lO): 
echo "Produit des nombres de 1 
$tab2 = array(7,12.15.3,21); 
echo "Produit des éléments :", 
?> 

</div> 
</body> 
</html> 

Le script retourne le résultat suivant 



à 10 :". prod($tabl),"<br />" 
prod($tab2),"<br />": 



Produit des nombres de 1 à 10 : Il 
produit vaut 3628800 

Produit des éléments :I1 y a 5 paramètres :7 



y a 10 paramètres :1, 2, 3, 4. 5, 6, 7, 8, 9. 10. 

12. 15. 3. 21. le produit vaut 79380 



Les fonctions particulières de PHP 

Vous pouvez obtenir des informations sur les paramètres d'une fonction à l'aide de fonc- 
tions spécialisées de PHP. 

La fonction suivante : 

I integer f unc_num_args( ) 

s'utilise sans argument et seulement dans le corps même d'une fonction. Elle retourne le 
nombre d'arguments passés à cette fonction. 

Pour accéder à chacun des paramètres, vous utilisez ensuite la fonction : 
I divers func_get_arg( integer $N) 

qui retourne la valeur du paramètre passé à la position $N. Comme dans les tableaux, le 
premier paramètre a l'indice 0. Vous pouvez donc lire chacun des paramètres à l'aide 
d'une boucle. 

La fonction suivante : 

I array f unc_get_args( ) 

s'utilise sans paramètre et retourne un tableau indicé contenant tous les paramètres 
passés à la fonction personnalisée. 

Pour illustrer l'utilisation de ces deux fonctions, vous allez réécrire la fonction prod( )de 
l'exemple 7-7 pour détecter le nombre et la valeur des paramètres sous deux formes 
différentes et en faire le produit. 

La fonction prodK ) détermine le nombre de paramètres à l'aide de func_num_args( ) puis 
les lit un par un à l'aide d'une boucle for. La fonction prod2( ) récupère le tableau conte- 
nant l'ensemble des paramètres à l'aide de func_get_args( ) puis les récupère à l'aide 
d'une boucle foreach. 
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Remarque 

La définition des fonctions prodK ) et prod2( ) ne contient plus l'énumération des paramètres mais ce 
n'est pas obligatoire. Vous pouvez très bien préciser un nombre minimal de paramètres et en passer 
davantage — mais jamais moins — lors de l'appel. 



'•^ Exemple 7-8. Produit d'un nombre indéterminé de nombres 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>Produit d'un nombre indéterminé d'arguments</title> 

</head> 

<body> 

<div> 

<?php 

//Utilisation de f unc_num_arg( ) et func_get_arg( ) 

function prodlO 

{ 

$prod = 1; 

//détermine le nombre d'arguments 
$n=func_num_args( ) ; 
for($i=0;$i<$n;$i++) 
{ 

echo func_get_arg($i ) ; 
($i==$n-l)?print(" = "):print(" * "): 
$prod *=func_get_arg($i ) : 

} 

return $prod; 

} 

//Appels de la fonction prodlO 

echo "Produit des nombres :", prodl(5,6,7 ,8,11 ,15) , "<br />"; 
$a=55:$b=22;$c=5:$d=9; 

echo "Produit de " ,prodl($a ,$b,$c,$d) , "<hr />"; 
//Utilisation de func_get_args( ) seule 

/ /■k-k-k-k-h-k-k-k-k-k-k-h-k-k-k-k-k-k-k^'k-k-k-k-k'k-k-k-k-k-k-k-k'k-k* 

function prod2() 
{ 

$prod = 1; 

//Récupération des paramètres dans un tableau 
$tabparam = f unc_get_args( ) ; 
foreach($tabparam as $cle=>$val) 

{ 

//Présentation 
echo $val ; 
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($cle==count($tabparam)-l)?print(" = "):print(" * "); 

//Calcul du produit 
$prod *=$val ; 

) 

return $prod; 

} 

echo "Produit des nombres :", prod2(5 ,6,7,8,11 , 15) , "<br />"; 
$a=55:$b=22:$c=5:$d=9: 

echo "Produit de " ,prod2($a , $b,$c,$d) , "<hr />"; 
?> 

</div> 

</body> 

</html> 

Vous obtenez l'affichage suivant pour les deux fonctions : 



Produit des nombres :5 * 6 * 7 * 8 * 11 * 15 = 277200 
Produit de 55 * 22 * 5 * 9 = 54450 



Portée des variables 

Toutes les variables ont une portée déterminée selon le contexte. 

Variables locales et globales 

Toutes les variables utilisées dans la déclaration d'une fonction sont, sauf indication 
contraire, locales au bloc de définition de la fonction. Cela permet d'utiliser n'importe 
quel nom de variable dans le corps de la fonction et comme valeur de retour, même si ce 
nom est déjà utilisé dans le reste du script (il vaut toutefois mieux éviter ces répétitions 
de noms de variables). Toutes les variables qui sont définies en dehors d'une fonction ou 
d'une classe sont globales et accessibles partout dans le script qui les a créées. 

En conséquence, toute modification du paramètre d'une fonction opérée dans le corps de 
celle-ci n'a aucun effet sur une variable externe à la fonction et portant le même nom. 

Dans l'exemple 7-9, la fonction waytuO utilise le paramètre $interne, qui est local à la 
fonction, et les deux variables globales $interne et $externe, initialisées en dehors de la 
fonction. Quelle que soit la variable utilisée lors des appels de la fonction, les deux varia- 
bles globales $externe et $interne ne sont pas modifiées, comme le montrent les résultats 
affichés. 

Le corps de la fonction comprend également la variable locale $externe — une exception 
à la règle énoncée précédemment. L'affectation d'une valeur à cette variable ne se réper- 
cute pas en dehors du corps de la fonction, la variable globale $externe (repère O) 
gardant sa valeur initiale. 
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'■^ Exemple 7-9. Variables locales et globales 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=iso-8859-r' /> 

<title>Variables locales et variables globales</title> 

</head> 

<body> 

<div> 

<?php 

$externe="dehors" ; <— O 
$interne ="dedans"; 
function waytu($interne) 
{ 

$interne = "Si tu me cherches, je suis ".Sinterne ." <br />"; 
$externe = "n'importe quoi!"; 
return $interne; 

} 

echo waytu($interne) ;//affiche "Si tu me cherches, je suis dedans" 
echo $interne," <br />" ://affiche "dedans" 

echo waytu($externe) ://affiche "Si tu me cherches, je suis dehors" 

echo $externe," <br />" ;//affiche "dehors" 

?> 

</div> 
<P> 

<a href="http: //val idator.w3.org/check?uri=referer"><img 
s rc="http: //www. w3.org/Icons/ val id-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 

</p> 

</body> 

</html> 

Si vous souhaitez utiliser la valeur d'une variable globale dans le corps d'une fonction, il 
vous faut déclarer cette variable dans le corps de la fonction en la faisant précéder du 
mot-clé gl obal pour les versions de PHP antérieures à la 4.1 et, de manière plus élégante 
depuis, en utilisant le tableau associatif superglobal SGLOBALS. Les clés de ce dernier sont 
les noms des variables globales du script sans le signe "$". 

Pour utiliser la valeur de la variable globale $mavar, vous écrivez par exemple : 

I $GLOBALS["mavar"] 

L'exemple 7-10 illustre l'emploi de variables globales dans une fonction pour rédiger un 
message. La fonction messageO utilise le paramètre $machin, qui contient le nom d'une 
ville, et les valeurs des variables globales $truc et $intro déclarées de deux manières 
différentes. 
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<^ Exemple 7-10. Utilisation de variables globales dans une fonction 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtcl"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>Fonctions utilisant des variables globales</title> 

</head> 

<body> 

<div> 

<?php 

function message($machin) 
{ 

global $truc: 

Smachin = $GLOBALS['intro']." je suis $truc Smachin <br />": 
$truc = "zzzzzzzzzzzzzzzzzzzzz! " ; 
return $machin; 

1 

$intro= "Ne me cherches pas,"; 

$truc = " parti "; 

echo message(" à Londres"); 

$intro= "Si tu me cherches,"; 

$truc=" revenu "; 

echo message(" de Nantes"); 

echo $truc; 

?> 

</div> 

</body> 

</html> 

Le script retourne le résultat suivant : 



Ne me cherches pas, je suis partie à Londres 
Si tu me cherches, je suis revenue de Nantes 
zzzzzzzzzzzzzzzzzzzzz! 



Chaque modification de la valeur des variables $truc et $intro est sensible dans la fonc- 
tion messageO. En particulier, la modification de la variable globale $truc dans le corps 
de la fonction est répercutée dans le reste du script, ce qui peut créer un danger si vous 
n'y prenez garde. 

Par précaution, il est recommandé de n'utiliser les variables globales dans une fonction 
que comme source de donnée et de ne pas modifier leur valeur. Si, comme il convient, 
vous prenez la bonne habitude de constituer des bibliothèques de fonctions externes, le 
code de celles-ci n'est plus visible directement. L'utilisation de variables globales risque 
d'opérer des modifications sans qu'elles soient visibles. La recherche d'erreurs peut alors 
devenir difficile. 
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Les variables statiques 

Lors de l'appel d'une fonction, les variables locales utilisées dans le corps de la fonction 
ne conservent pas la valeur qui leur est affectée par la fonction. La variable redevient en 
quelque sorte vierge après chaque appel. 

Pour conserver la valeur précédemment affectée entre deux appels d'une même fonction, 
il faut déclarer la variable comme statique en la faisant précéder du mot-clé stati c, et ce 
avant de l'utiliser dans le corps de la fonction. Le deuxième appel de la fonction peut 
réutiliser la valeur qu'avait la variable après le premier appel de la fonction, et ainsi de 
suite à chaque nouvel appel. 

L'utilisation typique des variables statiques concerne les fonctions qui effectuent des 
opérations de cumul. Une variable déclarée comme stati c ne conserve toutefois une 
valeur que pendant la durée du script. Lors d'une nouvelle exécution de la page, elle 
reprend sa valeur initiale. Il ne faut donc pas compter sur cette méthode pour transmettre 
des valeurs d'une page à une autre, même si ces dernières appellent la même fonction 
contenant des variables statiques. 

Dans l'exemple suivant : 

function acquis($capital ,$taux) 
{ 

static $acquis; 
//corps de la fonction 
} 

la variable $acqui s n'a pas de valeur initiale et doit être affectée dans la suite du code. Par 
contre, vous pouvez lui donner une valeur initiale lors de sa déclaration en écrivant : 

function acquis($capital ,$taux) 
{ 

static $acquis=l; 
//corps de la fonction 
} 

L'exemple 7-11 crée une fonction acquis( ) qui affiche successivement les valeurs acqui- 
ses d'un placement réalisé à un taux fixe. L'utilisateur choisit le capital et le taux dans 
deux champs texte d'un formulaire de saisie, nommés capital et taux. 

Vous utilisez dans le corps de la fonction deux variables statiques, $acquis et San, qui 
représentent le coefficient multiplicateur du prêt et la durée du placement. Entre chaque 
appel de la fonction, ces variables conservent leur valeur pour permettre d'afficher la 
valeur acquise année après année à l'aide d'une boucle. 

La fonction retourne la valeur acquise totale à chaque appel et crée une boîte d'alerte en 
JavaScript contenant la même valeur du capital acquis. 

La partie XHTML du fichier consiste uniquement en la création du formulaire de saisie 
des informations nécessaires au calcul du placement. 
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<^ Exemple 7-1 1 . Utilisation d'une variable statique 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-r' /> 

<ti tl e>Vari ables statiques</ti tl e> 

</head> 

<body> 

<form method="post" action="fonctionll.php" > 
<fieldset> 

<1 egend>Pl acements</l egend> 
<p>Indiquez votre CAPITAL : 

<input type="text" name="capitar' value=""/></p> 

<p>Indiquez votre TAUX en %: 

<input type="text" name="taux" val ue=" "/></p> 

<input type="submit" name="cal cul " val ue="CALCULER"/><br /> 

</fieldset> 

</form> 

</body> 

</html> 

<?php 

//Définition de la fonction 
function acquis($capital ,$taux) 
{ 

static $acquis=l: 
static $an=l; 
$coeff = l+$taux/100; 
Sacquis *= $coeff; 

echo "<script type=\"text/javascript\" > alertC'En $an ans vous 
Saurez ". round($capital*$acquis,2) ." euros') </script>"; 
$an-H-; 

return round($capital*$acquis,2) ; 

} 

//Utilisation de la fonction 

if(isset($_POST["taux"])&& isset($_POST[" capital "])&& 
^is_numeric($_POST[ "capital "]) && is_numeric($_POST["taux"])) 
{ 

for($i=l:$i<5;$i++) 

{ 

echo "Au bout de $i ans vous aurez ". acquis($_POST["capital "] , 
^$_POST["taux"]) . " euros <br />"; 

) 

} 

?> 

La figure 7-4 donne un aperçu du formulaire de saisie ainsi que de l'affichage des résul- 
tats dans la page et sous forme de boîte d'alerte JavaScript. 
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Fichier Édrtron Mfichage Historique M^^qu^paQ^ Outils ? 



• ^ ^\ I , I hllp;//vvww.fuiihliiil.L uiii/php5/C7fui».timia/fui».Liuiill.plip ^ • | |lGI • | Guuytc 



r" Placements" 



Indiquez votre CAPITAL : | 
Indiquez votre TAUX en %; 
I CAir.lilFR~| 



An bout de 1 ans vous aurez 10550 euros 
Au bout de 2 ans vous aurez 1 1 130-25 euros 
Auboutde3 aiu vous aurez 11742-41 etiros 
Aubuui de 4 cflii \uui auici 123S8-25 cmui 



Annonce de la page httpy/www.funhtml.com ; 



A En 4 



ans vous aurez 1238825 euros 



Figure 7-4 

Utilisation des variables statiques dans un formulaire de saisie 



Passer des arguments par référence 

Dans les définitions des fonctions que vous venez de créer, les arguments sont passés par 
valeur. C'est donc une copie de ces variables qui est utilisée par la fonction. En aucun cas 
les modifications de la valeur des paramètres ne sont visibles à l'extérieur de la fonction. 

Comme vous l'avez vu au chapitre 2 pour l'affectation des variables par référence, il est 
possible de passer à une fonction un argument par référence. Dans ce cas, les modifica- 
tions effectuées dans le corps de la fonction sont répercutées à l'extérieur. 

Vous avez le choix entre deux possibilités, passer des arguments par référence de façon 
systématique (voir l'exemple 7-12) et passer des arguments par référence occasionnelle- 
ment (voir l'exemple 7-13). 

Si vous voulez que le passage des arguments par référence soit fait systématiquement, il 
vous faut faire précéder les paramètres que vous désirez passer par référence du signe & 
dans la définition de la fonction elle-même. 

Vous utilisez pour cela la syntaxe suivante : 

function nom_fonction(&$parainl,&$parani2 ) 

{ 

//corps de la fonction 
} 

Il n'y a pas obligation de passer tous les paramètres par référence dans la même fonction, 
et vous pouvez n'en passer qu'une partie. Dans l'exemple 7-12, la fonction prod( ) reçoit 
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comme paramètre un tableau passé par référence et un coefficient passé par valeur. La 
fonction vérifie d'abord que chaque élément du tableau est numérique. Si tel est le cas, il 
est multiplié par le coefficient passé en second paramètre. 

La fonction retourne ensuite un tableau contenant ces nouvelles valeurs, ou, si un seul 
des éléments n'est pas numérique, retourne FALSE. 

L'ensemble des résultats du script montre que le tableau passé en paramètre a été modifié 
et qu'il est le même que celui retourné par la fonction (la variable $result). En pratique, 
il serait inutile de retourner une valeur dans le corps de la fonction. Remarquez bien en 
revanche que toutes les valeurs initiales sont perdues. 

'•^ Exemple 7-12. Passage d'arguments par référence 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtiiilll/DTD/xhtmlll.dtd"> 
<htm1 xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/htnil ; charset^i so-8859-r' /> 

<title>Passage par référence</title> 

</head> 

<body> 

<div> 

<?php 

//Définition de la fonction 
function prod(&$tab,$coeff ) 
{ 

foreach($tab as $cle=>$val) 
{ 

if(is_numeric($val )) 

{$tab[$cle]*=$coeff;) 

else 

{ 

echo "Erreur : Le tableau est non numérique <br />"; 
return FALSE; 

} 

) 

return $tab; 

} 

echo "Tableau numérique <br />"; 
Stabnum = range(l,7) ; 

echo "Tableau avant l'appel <br />",print_r( Stabnum) . "<br />"; 
//Passage du tableau à la fonction 
$result= prod($tabnum,3.5) : 

echo "Tableau résultat <br />",print_r( $resul t) , "<br />"; 

echo "Tableau initial après l'appel <br />",print_r( Stabnum) , "<br />"; 

echo "Tableau alphabétique <br />"; 

$tabalpha= range( "A" , "F" ) ; 

Sresul tal =prod($tabal pha ,3) ; //retourne FALSE 

echo "Tableau après l'appel <br />",print_r( Stabal pha) , "<br />"; 
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?> 

</div> 

</body> 
</html> 

Le script retourne le résultat suivant : 



Tableau numérique 
Tableau avant l 'appel 

Array ( [0] 1 [1] => 2 [2] => 3 [3] 4 [4] => 5 [5] => 6 [6] => 7 ) 1 
Tableau résultat 

Array ( [0] 3.5 [1] 7 [2] => 10.5 [3] 14 [4] 17.5 [5] => 21 [6] 24.5 ) 1 
Tableau initial après l'appel 

Array ( [0] 3.5 [1] 7 [2] => 10.5 [3] 14 [4] 17.5 [5] 21 [6] 24.5 ) 1 

Tableau alphabétique 

Erreur : Le tableau est non numérique 

Tableau après 1 'appel 

Array ( [0] A [1] => B [2] => C [3] D [4] => E [5] => F ) 1 



La deuxième possibilité s'offre à vous si vous voulez que le passage des arguments par 
référence ne soit pas systématique mais occasionnel et choisi à chaque appel de la fonction. 

Dans ce cas, vous définissez la fonction comme pour un passage des arguments par 
valeur. C'est seulement lors de l'appel que vous choisissez le passage par référence en 
faisant précéder chaque paramètre du signe &. 

Il est alors évident que vous ne pouvez plus passer de valeurs scalaires mais seulement 
des variables. L'exemple 7-13 en donne une illustration. 

'•^ Exemple 7-13. Passage par référence occasionnel 

<?php 

//Définition de la fonction 
function &hausse($prix, $pourcent) 
{ 

$prix *=(l+$pourcent/100) ; 
return round($prix,2) ; 

} 

//Utilisation de la fonction 
$prix = 1500; 

echo hausse($prix,12) ,"<br />";//par valeur 
echo $prix,"<br />"; 

echo hausse(&$prix,12),"<br />";//par référence 

echo $prix,"<br />"; 

?> 

L'instruction suivante : 
I echo hausse($prix,12) 
affiche la valeur 1680, et : 
I echo $prix 
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affiche 1500, montrant que la valeur de la variable $prix, passée par valeur, n'a pas été 
modifiée. 

L'appel de la fonction par le code suivant : 
■ echo hausse(&$prix.l2) 

affiche le même résultat, mais il est nécessaire de vérifier ensuite que la variable $prix 
vaut également 1680, le deuxième appel étant fait par référence. Cette deuxième solution 
est préférable lorsque vous souhaitez créer des bibliothèques de fonctions dont le code ne 
soit pas directement visible dans le script. Ainsi, le passage par référence ne risque pas 
d'être involontaire. 

Cette possibilité est toutefois considérée aujourd'hui comme obsolète, et le passage par 
référence doit faire partie de la déclaration de la fonction. En conséquence, il est important 
de bien documenter vos fonctions pour ne pas oublier quels sont les arguments passés par 
référence et ceux qui ne le sont pas. 

Cas particuliers 

Dans cette section, nous allons examiner divers cas particuliers qui peuvent se révéler 
utiles. A savoir les fonctions dynamiques, les fonctions conditionnelles, les fonctions 
définies à l'intérieur d'une autre fonction et les fonctions récursives. 

Les fonctions dynamiques 

Les fonctions que vous avez écrites jusqu'à présent ont un nom fixe et bien défini dans 
les scripts. La lecture du script permet de connaître immédiatement la fonction appelée. 
PHP offre la possibilité de travailler avec des noms de fonctions dynamiques, qui peuvent 
être variables et donc dépendants de l'utilisateur du site ou de l'interrogation d'une base 
de données. 

Pour réaliser cette opération, il faut que le nom de la fonction — sans les parenthèses ni 
les paramètres — soit contenu dans une variable de type chaîne de caractères. Pour utiliser 
la fonction il n'y a plus ensuite qu'à faire suivre cette variable de parenthèses et de ses 
paramètres éventuels. 

Le code suivant : 

|$ch ="phpinfo" ; 
$ch(): 

équivaut au code : 

I phpinfoO 

qui appelle directement la fonction phpinfoO. 
De même, le code suivant : 

|$ch = "date"; 
echo $ch(" D d/M/Y H:i :s "); 



212 



PHP 5 



permet d' appeler la fonction date ( ) avec comme paramètre la chaîne "D d/M/Y H:i:s". 

Il est envisageable de créer un tableau de chaînes contenant des noms de fonctions et 
d'appeler celles-ci en écrivant le nom de l'élément du tableau suivi de parenthèses et de 
paramètres s'il en existe. 

Le code suivant : 

<?php 

$tabfonc= array( "phpinfo" , "date" ) ; 
$tabfonc[0](); 

echo $tabfonc[l]("D d m Y H:i:s"): 
?> 

serait ainsi l'équivalent des précédents. 

Pour illustrer les possibilités des fonctions dynamiques, l'exemple 7-14 crée un formu- 
laire de saisie permettant à l'utilisateur d'entrer un nom de fonction native de PHP et la 
valeur d'un paramètre. L'envoi du formulaire provoque l'affichage de la valeur désirée. 

Le formulaire contient deux zones de saisie de texte. La première, nommée "fonction", 
permet la saisie du nom de la fonction, et la seconde, nommée "param", de la valeur du 
paramètre. 

Le code contenu dans l'attribut value des éléments <input /> (repères O) permet de 
conserver l'état du formulaire avant son envoi et donc de réafficher les données saisies 
par l'utilisateur 

Le code PHP de gestion du formulaire vérifie d'abord l'existence d'une saisie de nom de 
fonction et d'un paramètre (repère ©) puis, s'ils existent, vérifie que la fonction choisie 
existe en PHP (ou dans le script lui-même repère 0) puis, selon les cas, affiche la valeur 
désirée (repère ©) ou un message d'erreur (repère 0). 

'•^ Exemple 7-14. Fonctions dynamiques 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=i so-8859-1" /> 

<ti tl e> Fonctions dynamiques</ti tle> 

</head> 

<body> 

<form method="post" action="fonctionl4.php" > 
<fieldset> 

<legend>Choisissez votre fonction et son paramètre</l egend> 
<inpLit type="text" name="fonction" value="<?= 
^isset($_POST["fonction"]) ? $_POST["fonction"] : "" ?>"/><— O 
<input type="text" name="param" value="<?= isset($_POST["param"]) ? 
^$_POST["param"] : ?>"/><-0 
<input type="submit" val ue="Cal cul er"/> 
</fieldset> 
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</form> 

<!-- Code PHP : gestion du formul ai re--> 
<?php 

if((isset($_POST["fonction"])&& $_POST["fonction"]! = "") && $_POST["param"] ! = "" ) <-© 
{ 

Sfonction = $_POST["fonction"] : 
$param = $_POST["param"] ; 
if (function_exi st s ($f onction) ) <— 0 
{ 

echo "Résultat : $fonction($param) = " , $fonction($param) ; <— © 

} 

else echo "ERREUR DE FONCTION! "; ^0 

} 

?> 

</body> 
</html> 

La figure 7-5 montre le résultat obtenu en choisissant la fonction log. 

Fonctions dynamiques - Mozîlla Rrefox 



Rchier Édition Affichage Historique Marque-pages Outils ? 
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' Choisissez votre fonction et son paramétre ~ 



log 2000 



a 



Résultat : log(2000) = 7.6009024595421 



Figure 7-5 

Utilisation de fonctions dynamiques 



Les fonctions conditionnelles 

Une fonction est dite conditionnelle si elle est définie à l'intérieur d'un bloc i f . Sa création 
se réalise alors de la même façon que pour une fonction ordinaire, mais elle n'est utilisable 
que si l'instruction if qui la contient a été exécutée et, bien sûr, si l'expression condi- 
tionnelle contenue dans if a la valeur booléenne TRUE. Ces conditions étant remplies, la 
fonction peut être appelée normalement dans tout le code qui suit la condition i f . 

L'exemple 7-15 illustre cette possibilité. L'appel de la fonction ordinaire testO 
(repère Q) montre que l'on peut l'appeler alors même qu'elle n'est définie qu'en fin de 
script (repère 0), ce que nous avons déjà vu. Par contre, l'appel de la fonction sal ut( ) en 
début de script (repère 0) provoquerait une erreur fatale (message: Fatal error: Call to 
undef ined function salut( )) et donc l'arrêt immédiat du script. Cette fonction est en effet 
conditionnelle et n'est accessible que lorsque le script atteint la ligne du if (repère 0) 
qui vérifie si l'heure obtenue par la fonction dateO (repère 0 : voir le chapitre 8 pour 
plus de détails sur son fonctionnement) est inférieure à 18. Dans ce cas la fonction 
salutO est définie (repère 0). Notre exemple pourrait s'arrêter là mais, dans le but 
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d'éviter l'erreur fatale signalée ci-dessus, nous utilisons un bloc el se (repère ©) qui crée 
une autre version de la fonction sal ut( ) quand la condition if n'est pas vérifiée. L'appel 
de cette fonction est alors possible en fin de script (repère ©) 

'•^ Exemple 7-15. Fonctions conditionnelles 

<?php 

teste ); <-0 

//salutO; Cet appel provoquerait une erreur fatale^— 0 

$heure=date("H") : ^0 

//Définition d'une fonction conditionelle 

if($heure<18) 

{ 

function salut()<— @ 
{ 

echo "Bonjour : Fonction accessible seulement avant 18h00 <br />"; 

) 

} 

else ^0 
{ 

function salutO 
{ 

echo "Bonsoir : Fonction accessible seulement après 18h00 <br />"; 

) 

} 

//Définition d'une fonction ordinaire 

function test()<— 0 

{ 

echo "Fonction accessible partout <br />"; 
return TRUE; 

} 

salutO; <-0 
?> 

Fonction définie dans une autre fonction 

Dans le cas d'une fonction définie à l'intérieur d'une autre fonction, le code de création 
de la fonction n'est plus dans un bloc if mais dans le bloc qui constitue le corps d'une 
autre fonction. La fonction incluse n'est alors utilisable que si celle qui la contient a été 
appelée une fois, sinon PHP lève une erreur fatale. L'inconvénient de cette méthode est 
que la fonction « conteneur » ne doit être appelée qu'une seule et unique fois, sinon nous 
obtenons à nouveau une erreur fatale pour cause de redéfinition de la fonction incluse ce 
qui, avouons-le, rend cette fonctionnalité un peu dangereuse. L'exemple 7-16 illustre 
cette possibilité de création de fonction. Le script contient la définition de la fonction 
parent( ) qui contient elle-même la définition de la fonction enfant ( ) (repère 0). L'appel 
de cette dernière en début de script provoquerait une erreur fatale (repère Q) mais, lors- 
que que la fonction parente ) a été appelée une fois (repère 0), la fonction enfant () peut 
être appelée autant de fois que l'on veut (repères 0 et 0). 
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<^ Exemple 7-16. Fonction incluse dans une autre 

<?php 

//enfant();//ERREUR FATALE 
function parent()<— © 
{ 

echo "Bonjour les enfants! <br />"; 
function enfant()<— © 

{ 

echo "Bonsoir papa !<br />"; 

} 

} 

parente ) ; <— O 
enfante ); ^0 
enfante ); <— © 
?> 

Le script affiche les résultats suivants : 



Bonjour les enfants! 
Bonsoir papa ! 
Bonsoir papa ! 



Les fonction récursives 

Une fonction est dite récursive si, à l'intérieur de son corps, elle s'appelle elle-même 
avec une valeur de paramètre différent (sinon elle boucle). Chaque appel constitue un 
niveau de récursivité. L'exemple le plus classique est celui de la fonction qui retourne la 
factorielle d'un nombre entier n (notée n! que nous avons déjà calculée d'une manière 
différente à l'exemple 7-7). Pour calculer n!, une fonction récursive calcule n x (n - 1)!, 
ce qui implique un nouvel appel de la fonction factorielle et ainsi de suite jusqu'à calculer 
1 ! (par définition 0!=1) puis on remonte jusqu'à n!. 

Ce qui donne, par exemple, le code suivant : 

<?php 

function facto($n) 
{ 

if ($n==l) return 1; 

else {return $n*facto($n-l) ; } 

} 

echo "factorielle = " ,facto(150) ; 
?> 

Un grand autre classique de la récursivité est la programmation du jeu dit des tours de 
Hanoï. Imaginé par le mathématicien français Edouard Lucas, il consiste à déplacer des 
disques de diamètres croissants d'un piquet de « départ » à une piquet d'« arrivée » en 
passant par un piquet « intermédiaire » et ceci en un minimum de coups, sachant qu'on 
ne peut déplacer qu'un disque à la fois et que celui-ci ne peut être placé que sur un disque 
plus grand que lui ou sur un piquet vide. Au départ les disques sont empilés sur un des 
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piquets en ordre décroissant. La figure 7-6 présente une configuration de départ avec six 
disques. 



1^ I II 

Figure 7-6 

Les tours de Hanoï 

Pour programmer le jeu, les piquets seront numérotés de 1 à 3 de gauche à droite, et on 
remarquera que le piquet intermédiaire a le numéro 6 - « départ » - « arrivée ». Quand le 
nombre de disques est faible (au minimum 3) il est assez aisé de gagner mais, lorsqu'il 
augmente, ceci demande un peu de réflexion car il faut parvenir au résultat en un mini- 
mum de coups. Pour une quantité N de disques, ce nombre de coups minimum est 
toujours égal à 2'^- 1. Comme pour la factorielle, l'idée générale pour effectuer une 
action pour N disques est de la réaliser d'abord pour N - 1 disques, puis pour N - 2 et 
ainsi de suite jusqu'à un seul disque ce qui constitue une action élémentaire facile. On 
remonte alors pas à pas jusqu'à N. Pour déplacer, par exemple, trois disques du piquet 1 
vers le piquet 2 on effectue les opérations suivantes : 



Déplacez un disque du piquet 1 vers le piquet 2 

Déplacez un disque du piquet 1 vers le piquet 3 

Déplacez un disque du piquet 2 vers le piquet 3 

Déplacez un disque du piquet 1 vers le piquet 2 

Déplacez un disque du piquet 3 vers le piquet 1 

Déplacez un disque du piquet 3 vers le piquet 2 

Déplacez un disque du piquet 1 vers le piquet 2 



L'exemple 7-17 donne le code de résolution du jeu. S'il reste un disque à déplacer nous 
avons l'action élémentaire du départ vers l'arrivée (repère O) sinon il faut déplacer N - 1 
disques du départ vers l'intermédiaire (repère©) puis N-1 disques de l'intermédiaire 
vers l'arrivée (repère ©). 

f*" Exemple 7-1 7. Les tours de Hanoï 

<?php 

function hanoi ($nb,$dep,$arr) 

{ 

if ($nb==l) echo "Déplacez un disque du piquet $dep vers le piquet 

^$arr <br />"; <-© 

else 

{ 

$inter=6-$dep-$arr; 
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hanoi ($nb-l , $dep,$inter) : <— 0 

echo "Déplacez un disque du piquet $dep vers le piquet $arr <br />"; 
hanoi ($nb-l,$inter,$arr) : <— 0 

} 

} 

hanoi(4,1.2): 
?> 



L'affichage des opérations réalisées pour déplacer quatre disques du piquet 1 vers le 
piquet 2 est le suivant : 



1 


Déplacez 


un 


disque 


du 


piquet 


1 


vers 


1 e 


piquet 


3 


2 


Dépl acez 


un 


disque 


du 


piquet 


1 


vers 


1 e 


piquet 


2 


3 


Dépl acez 


un 


disque 


du 


piquet 


3 


vers 


1 e 


piquet 


2 


4 


Dépl acez 


un 


di sque 


du 


piquet 


1 


vers 


1 e 


piquet 


3 


5 


Dépl acez 


un 


di sque 


du 


piquet 


2 


vers 


1 e 


piquet 


1 


6 


Dépl acez 


un 


di sque 


du 


piquet 


2 


vers 


1 e 


piquet 


3 


7 


Dépl acez 


un 


di sque 


du 


piquet 


1 


vers 


1 e 


piquet 


3 


8 


Dépl acez 


un 


di sque 


du 


piquet 


1 


vers 


1 e 


piquet 


2 


9 


Dépl acez 


un 


disque 


du 


piquet 


3 


vers 


1 e 


piquet 


2 


10 


Dépl acez 


un 


di sque 


du 


piquet 


3 


vers 


1 e 


piquet 


1 


11 


Dépl acez 


un 


di sque 


du 


piquet 


2 


vers 


1 e 


piquet 


1 


12 


Dépl acez 


un 


di sque 


du 


piquet 


3 


vers 


1 e 


piquet 


2 


13 


Dépl acez 


un 


di sque 


du 


piquet 


1 


vers 


1 e 


piquet 


3 


14 


Dépl acez 


un 


disque 


du 


piquet 


1 


vers 


1 e 


piquet 


2 


15 


Dépl acez 


un 


disque 


du 


piquet 


3 


vers 


1 e 


piquet 


2 



Il comporte bien 15 déplacements (soit 2^ - 1) et on peut remarquer que les lignes paires 
du déplacement hanoi(4,l,2) correspondent au déplacement hanoi(3,l,2). 



Exercices 

Exercice 1 

Créez une fonction PHP qui affiche une boîte d'alerte à partir de la fonction JavaScript 
dont la syntaxe est alert("chaine_de caractères"). Cette fonction peut être appelée avec 
comme paramètre le texte du message à afficher. Elle est particulièrement utile pour affi- 
cher des messages d'erreur de manière élégante, sans que ces derniers restent écrits dans 
la page. 

Exercice 2 

Écrivez une fonction de lecture de tableaux multidimensionnels en vous inspirant de 
l'exemple 7-3. L'affichage se fait sous forme de tableau XHTML dont les titres sont les 
clés des tableaux. 

Exercice 3 

Ecrivez une fonction qui retourne la somme de la série de terme général m,, = x^" + '/«!. 
Les paramètres de la fonction sont n pour le nombre d'itérations et d pour le nombre de 
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décimales affichées pour le résultat. Il est possible de réutiliser la fonction prod( ) présen- 
tée dans ce chapitre pour calculer la factorielle n\. 

Exercice 4 

Écrivez une fonction dont le paramètre passé par référence est un tableau de chaînes de 
caractères et qui transforme chacun des éléments du tableau de manière que le premier 
caractère soit en majuscule et les autres en minuscules, quelle que soit la casse initiale 
des éléments, même si elle est mixte. 

Exercice 5 

À partir de la fonction sinus de PHP, écrivez une fonction qui donne le sinus d'un angle 
donné en radian, en degré ou en grade. Les paramètres sont la mesure de l'angle, et 
l'unité est symbolisée par une lettre. Le deuxième paramètre doit avoir une valeur par 
défaut correspondant aux radians. 

Exercice 6 

Créez une fonction de création de formulaires comprenant une zone de texte, une case 
d'option (radio button), un bouton Submit et un bouton Reset. Choisissez comme para- 
mètres les attributs des différents éléments XHTML en cause. Chaque appel de la fonc- 
tion doit incorporer le code XHTML du formulaire à la page. 

Exercice 7 

Décomposez la fonction précédente en plusieurs fonctions, de façon à constituer un 
module complet de création de formulaire. Au total, il doit y avoir une fonction pour l'en- 
tête du formulaire, une pour le champ texte, une pour la case d'option, une pour les 
boutons Submit et Reset et une pour la fermeture du formulaire. Incorporez ces fonctions 
dans un script, et utilisez-les pour créer un formulaire contenant un nombre quelconque 
de champ de saisie de texte et de cases d'option. 

Exercice 8 

Programmez les coefficients du binôme (ou triangle de Pascal). Pour mémoire, il s'agit 
de la suite suivante : 

1 

1 2 1 
13 3 1 
1464 1 
etc. 

La première colonne et la diagonale valent toujours 1 et chaque autre élément est égal à 
la somme de celui qui est au-dessus et de celui qui se trouve sur la diagonale gauche (par 
exemple 3=2-1-1 ou bien 6=3-1-3). 
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Les fonctions de date de PHP permettent d'afficher le jour, la date et l'heure sur les pages 
Web, qu'elles soient statiques ou créées dynamiquement. 

La gestion du temps se révèle non moins utile pour déterminer la durée de validité des 
cookies, stocker dans une base de données des informations de date de commande ou 
calculer un délai. 



Les dates 

La révolution du système décimal, il y a deux siècles, n'a pas atteint la gestion du temps. 
Vieux des premiers âges babyloniens, le système sexagésimal, consistant à diviser le 
jour en vingt-quatre heures de soixante minutes de soixante secondes, continue donc 
d'empoisonner nos calculs de durée. 

Les informaticiens ne pouvaient se contenter d'un système dans lequel l'ajout d'une 
seconde peut amener à changer d'heure, de jour, d'année et même de siècle ou de millé- 
naire. Pour pallier les difficultés de ce système, les informaticiens ont défini une date 
d'origine arbitraire, correspondant au P'' janvier 1970 00 h 00 m 00 s. A partir de cette 
date, le temps est compté en secondes. Ce nombre de secondes est nommé timestamp, ou 
instant UNIX. 



Timestamp négatif 

L'inconvénient de ce système est de fournir des timestamps négatifs pour les dates antérieures à l'origine. 
De plus, sous Windows, aucune des fonctions de date de PHP n'accepte comme paramètres les Instants 
UNIX négatifs, alors que les serveurs sous Linux les autorisent. 



La fonction timeO, que vous utiliserez souvent par la suite, retourne le timestamp de 
l'instant présent. Cette valeur n'est pas affichée au visiteur du site. Elle sert seulement 
d'intermédiaire sous-jacent pour calculer des durées et déterminer des dates futures ou 
passées. Le timestamp est alors passé à d'autres fonctions, qui réalisent l'affichage en clair 
de la date désirée. Un timestamp permet par ailleurs de stocker plus facilement une date 
à un seul nombre et constitue le moyen le plus sûr pour conserver une date dans une base 
de données. 

L'exemple 8-1 montre la manière d'utiliser cette fonction pour afficher le timestamp en 
cours directement avec la fonction timeO (repère O) ainsi que celui de dates futures 
(repère 0) et passées (repère 0). Il suffit pour cela d'ajouter ou d'enlever le nombre de 
secondes désiré. Pour calculer le nombre d'heures ou de jours correspondant au times- 
tamp de l'instant en cours, il suffit de diviser la valeur donnée par la fonction time( ) par 
3 600 pour le nombre d'heures (repère O) st par 3 600 puis 24 pour le nombre de jours 
(repère 0). 



Décalage horaire 

Le timestamp retourné par la fonction time( ) est bien sûr celui qui est calculé côté serveur. Il n'est pas 
forcément identique à celui du poste client. Il faut donc tenir compte du décalage horaire éventuel. 



Exemple 8-1 . La fonction time() 

<?php 

echo "A cet instant précis le timestamp est : ", time(),"<br />";<— 0 
echo "Dans 23 jours le timestamp sera : ", time( )+23*24*3600 , 
^"<br />": ^0 

echo "Il y a 12 jours le timestamp était : ". time( )-12*24*3600. "<br />"; <— 0 
echo"Nombre d'heures depuis le 1/1/1970 = " , round(time( )/ 3600), "<br />"; <— © 
echo"Nombre de jours depuis le 1/1/1970 = " , round(time( )/3600/ 24),"<br />":<— 0 
?> 

Le résultat obtenu à l'instant du test est le suivant : 



A cet instant précis le timestamp est : 1224522240 
Dans 23 jours le timestamp sera : 1226509440 
Il y a 12 jours le timestamp était : 1223485440 
Nombre d'heures depuis le 1/1/1970 = 340145 
Nombre de jours depuis le 1/1/1970 = 14173 



Les fonctions abordées dans les sections qui suivent vous permettront de trouver à quelle 
date précise ce test a été effectué. 

La fonction microtimeO fournit également le nombre de secondes et de microsecondes 
de l'instant en cours, mais en retournant non pas un nombre décimal mais une chaîne de 
caractères commençant par le nombre de microsecondes suivi du nombre de secondes. 
Cela est dû au manque de précision des nombres décimaux de type double, qui ne 
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permettent pas d'afficher suffisamment de chiffres significatifs. Il faut donc extraire les 
renseignements utiles de la chaîne à l'aide de la fonction substr( ), qui découpe la chaîne 
en deux sous-chaînes. 

Si le nombre de microsecondes ne présente aucun intérêt pour l'utilisateur, il se révèle en 
revanche très utile pour calculer des temps d'exécution. Le script de l'exemple 8-2 extrait 
les renseignements fournis par la fonction microtime( )(repères O et ©). Il calcule 
ensuite la durée d'exécution du script après l'ajout d'une boucle (repère 0), destinée à 
augmenter le temps d'exécution. Cette durée étant inférieure à la seconde, le calcul ne se 
fait que sur le nombre de microsecondes. Pour les durées plus longues, il faudrait calculer 
le nombre de secondes et de microsecondes. 

Si le nombre final est inférieur au nombre initial, la durée calculée est négative et donc 
fausse. Il est toutefois possible d'obtenir un résultat juste dans tous les cas en utilisant 
l'opérateur conditionnel ?, comme dans le code suivant : 

I $duree=($duree>0) ? ($duree) : (1000000+$duree) ; 

Exemple 8-2. Calcul de durée en microseconde 

<?php 

//La fonction microtimeO 
$temps = microtime( ) ; 

echo "Chaîne microtime = ". $temps."<br />"; 
//Lecture du nombre de microsecondes 
$microsec= (integer)substr($tenips.2,6) ; <— O 
//Lecture du nombre de secondes 
$sec = substr($tenips,ll,10); <— 0 

echo "À la microseconde près le timestamp est : $sec.$microsec secondes<br />"; 
echo "Le nombre de microseconde est: Smicrosec ^js<br />"; 
echo "Le nombre de seconde est: $sec secondes<br />"; 
$x=0; 

//Boucle pour perdre du temps 

for($i=0;$i<200000:$i-H-) <-© 

{$x+=$i:} 

//Temps final 

$tempsfin=microtime( ) ; 

$microsecfin = substr($tempsfin,2,6) ; 

$duree=$microsecf in-$niicrosec; 

$duree=($duree>0) ? ($duree) : ( 1000000+$duree) ; 

echo "Temps d'exécution du script=", $duree," microsecondes"; 

?> 

L'exemple retourne le résultat suivant : 



Chaîne microtime = 0.76500300 1224522453 

A la microseconde près le timestamp est : 1224522453.765003 secondes 

Le nombre de microsecondes est: 765003 ^js 

Le nombre de secondes est: 1224522453 secondes 

Temps d'exécution du script=28562 microsecondes 
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Ralentir un script 

Ce n'est généralement pas le but d'un programmeur, mais il peut être utile de retarder l'exécution d'un 
script. Il suffit d'appeler la fonction sleepCinteger N), qui crée un délai de N secondes. Pour créer 
un délai en microseconde, Il faut utiliser la fonction usleepdnteger N) en indiquant le nombre de micro- 
secondes N. 



Définir une date 

La fonction time( ) ne donne que le timestamp de l'instant en cours et se montre inadap- 
tée pour créer des dates déterminées antérieures ou postérieures. Pour cela, il faut avoir 
recours à la fonction mktime( ), dont la syntaxe est la suivante : 

Iint mktimednt heure, int minute, int seconde, int mois, int jour, int année, 
^int été) 

La fonction retourne le timestamp correspondant à la date définie par les valeurs entières 
passées en paramètres. La signification de ces valeurs est évidente, à l'exception de la 
dernière, qui doit valoir 1 pour l'heure d'hiver, 0 pour l'heure d'été et - 1, valeur par 
défaut, si vous ne savez pas. Comme expliqué précédemment, il est impossible de définir 
des dates antérieures au P'^ janvier 1970 sur un serveur sous Windows. 

Pour gérer des dates GMT, vous disposez de la fonction gmmktime( ), dont la syntaxe est la 
suivante : 

Iint gmmktime(int heure, int minute, int seconde, int mois, int jour, int année, 
^int été) 

Cette fonction retourne le timestamp correspondant à la date GMT. Elle peut servir à 
corriger la date et l'heure fournies par un serveur hébergé, par exemple, aux États-Unis. 
Les valeurs passées en paramètres sont identiques à celles de la fonction mktime( ). 

L'exemple 8-3 définit une date passée à l'aide de la fonction mktimeO (repère O) et 
calcule la durée écoulée jusqu'à l'instant présent (repère 0). Ces opérations sont répé- 
tées pour une date future (repères Q et Q). La fonction gmmktime( )mesure ensuite le 
décalage horaire du serveur par rapport à l'heure GMT (repères 0 et ©). 

f*' Exemple 8-3. Définition de dates et calcul de durées 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Ll/ZEN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=i so-8859-1" /> 

<title>Dates et durées</title> 

</head> 

<body> 

<div> 

<?php 
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//la fonction mktimeO 

$timepasse= mktime(12,5,30.5,30,1969) ; <— O 

$tinieaujour = time( ) ; 

Sduree = $timeaujour-$timepasse; <— 0 

echo "Entre le 30/05/1969 à 12h05in30s et maintenant il s'est écoulé", Sduree, 
^" secondes <br />"; 

echo "Soit ",round($duree/3600), " heures <br />"; 
echo "Ou encore ",round($duree/3600/24)," jours <br />"; 
Stimefutur = niktime(12,5,30,12,25,2008); 
$noel = $timefutur-$timeaujour; <— © 

echo "Plus que ",$noel, "secondes entre maintenant et Noël, soit ", 
^round($noel/3600/24)," jours. Patience! <br />";<— O 
//la fonction gmirktImeO 

$timepassegmt = gmmktime(12,5,30,5,30,1969) ; <— 0 

echo "Timestamp serveur pour le 30/5/1969= " ,$tiinepasse, "<br />"; 

echo "Timestamp GMT pour le 30/5/1969= " ,$tiinepassegint, "<br />"; 

echo "Décalage horaire = ",$timepasse-$timepassegmt," secondes<br />";<— O 

?> 

</div> 

</body> 

</html> 

L'exemple retourne le résultat suivant sur un serveur Linux : 



Entre le 30/05/1969 à 12h05m30s et maintenant il s'est écoulé 1243146454 secondes 
Soit 345318 heures 
Ou encore 14388 jours 

Plus que 5679146secondes entre maintenant et Noël, soit 66 jours. Patience! 
Timestamp serveur pour le 30/5/1969= -18622470 
Timestamp GMT pour le 30/5/1969= -18618870 
Décalage horaire = -3600 secondes 



Sur un serveur Windows, le même script affiche l'erreur suivante, qui confirme que les 
timestamps négatifs n'y sont pas admis : 



Warning: mktimeO: Windows does not support négative values for this function in c:\ 
eyrolles\php5\c8dates\date8.3.php on line 11 



Vérifier une date 

Dans un formulaire complété par un visiteur, il n'est pas rare que celui-ci indique une 
date, ne serait-ce que sa date de naissance. Même si une expression régulière peut vous 
permettre de vérifier si la saisie répond à un format imposé, par exemple JJ/MM/AAAA, 
elle ne peut vérifier si la date indiquée existe ou si le nombre des jours et celui des mois 
sont inversés. 
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Il peut être opportun dans de tels cas d'utiliser la fonction checkdate( ), dont la syntaxe est 
la suivante : 

I boolean checkdatednt mois, int jour, int année) 

La fonction checkdate( ) retourne une valeur booléenne TRUE si la date existe et FALSE dans 
le cas contraire. 

Dans l'exemple 8-4, la chaîne de caractères contenue dans la variable $_POST["date"] 
après l'envoi du formulaire est décomposée grâce à la fonction explodeO. Chaque 
élément de la date (jour, mois, année) est récupéré dans un élément de tableau (repère Q)- 
Les éléments $tabdate[l], $tabdate[0] et $tabdate[2] contiennent respectivement le jour, 
le mois et l'année saisies par l'utilisateur. Ces données sont ensuite passées comme argu- 
ments à la fonction checkdateO dans l'ordre «mois, jour, année» pour respecter la 
syntaxe de la fonction (repère 0). Un message s'affiche selon que la date est valide ou 
non (repères Q et Q). 

f*' Exemple 8-4. Formulaire de vérification de date 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>Validation de date</title> 

</head> 

<body> 

<form method="post" action="<?= $_SERVER["PHP_SELF"] ?>" > 
<fieldset> 

<legend>Entrez votre date de naissance sous la forme JJ/MM/AAAA</1 egend> 

<input type="text" name="date" /> 

<input type="submit" value="Envoi"/> 

</f1eldset> 

</form> 

<?php 

//checkdate 

if(1sset($_P0ST["date"])) 
{ 

$date=$_POST["date"]; 
$tabdate=expl ode( "/" , $date) ; 

if(!checkdate($tabdate[l],$tabdate[0],$tabdate[2]) ) {echo "<hr /> 
^La date $date n'est pas valide. Recommencez! <hr />";} 
else {echo "<h3> La date $date est valide. Merci ! </h3>" ; } 

} 

?> 

</body> 
[ </html> 
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Fichier Édition Affichage Historique Marque-pages Outils ? 



^ I , , ^ http://www.funhtml,conrT/php5/C8dates/datfi8.4.php ^ 



I [Valid] Markup Validation of http;//.„ X | □ VjSitaliaadedite 



'Entrez votre date de naissance sous la forme JJ.^MM^AAAA~ 



29/02/2012 



Envoi 



La date 29/02/2012 est valide. Merci! 



Figure 8-1 

Le formulaire de vérification des dates 



Afficher une date en clair 

La fonction dateO permet d'afficher une date selon des paramètres plus lisibles qu'un 
timestamp UNIX. Sa syntaxe est la suivante : 

I string dateCstring format_de_date, [int timestamp]) 

Elle retourne une chaîne contenant des informations de date dont la mise en forme est 
définie par des caractères spéciaux (voir leur signification au tableau 8-1). La date retour- 
née correspond à celle du timestamp passé en deuxième paramètre ou, si ce dernier est 
omis, à celle de l'instant en cours. 

Pour afficher un des caractères spéciaux du tableau 8-1 indépendamment de sa fonction 
de formatage, il faut le faire précéder d'un antislash. Par exemple, \h affiche le caractère 
« h » et non le nombre d'heure. Pour afficher les caractères « n » et « t », il faut écrire \\n 
et \\t car \n et \t sont employés pour le saut de ligne et la tabulation. 

Par exemple, pour obtenir l'affichage : 



Aujourd'hui Monday, 20 October 2008 il est 23:36:27 



vous écrivez : 

I echo "Aujourd'hui ".dateCl, d F Y \i\l \e\s\\t H:i:s "); 
La fonction date( ) tient compte de l'heure d'été. 

L'exemple ci-dessous utilise la fonction date( ) pour des timestamps futurs (repère O) ^t 
passés (repère 0) : 

Iecho "Dans 40 jours nous serons le ",date("l. d F Y H:i :s",time()+40*3600*24); <— O 
echo "Il y 24 jours nous étions le ",date("l, d F Y H:i :s",time()-24*3600*24), 
^"<br />": ^0 
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L'exemple retourne le résultat suivant : 



Dans 40 jours nous serons le Saturday, 29 November 2008 22:38:52 
Il y 24 jours nous étions le Friday, 26 September 2008 23:38:52 



Tableau 8-1 - Caractères de définition du format d'affichage 



Caractère de définition 


Définition et résultat affiché 


y 


L'année en deux ctiiffres (05 pour 2005) 


Y 


L'année en quatre ctiiffres (2005) 


L 


Affiche 1 si l'année est bissextile et 0 sinon. 


m 


Le mois en deux chiffres de 01 à 12 


n 


Le mois en un ou deux chiffres de 1 à 12 


M 


Le mois en trois lettres (en anglais) 


F 


Le mois en toutes lettres (en anglais) 


t 


Le nombre de jours du mois de 28 à 31 


d 


Le jour du mois en deux chiffres de 01 à 31 


j 


Le jour du mois en un chiffre de 1 à 31 


D 


Le jour de la semaine en trois lettres (en anglais) 


1 (petit L) 


Le jour de la semaine en toutes lettres (en anglais) 


w 


Le jour de la semaine codé de 0 pour dimanche à 6 pour samedi 


S 


Affiche le suffixe anglais « th » ou « nd » après les chiffres du jour. 


z 


Le jour de l'année de 0 à 366 


g 


Les heures de là 12 (avec AM et PM) 


h 


Les heures de 01 à 12 (avec AM et PM) 


G 


Les heures de 0 à 23 


H 


Les heures sur deux chiffres de 00 à 23 


a 


Ajoute « am » pour le matin ou « pm » pour l'après-midi. 


A 


Ajoute « AM » pour le matin ou « PM » pour l'après-midi. 


1 Les minutes en deux chiffres de 00 à 59 


s 


Les secondes en deux chiffres de 00 à 59 


U 


Affiche le timestamp UNIX. 


Z 


Donne le décalage horaire par rapport au temps GMT ou UTC en seconde, de -43 200 
à 43 200. 


T 


Affiche la ville significative du fuseau horaire, par exemple « Paris, Madrid ». 


I 


Affiche 0 pendant l'heure d'hiver et 1 pendant l'heure d'été. 


r 


Affiche la date complète au format RFC 822, par exemple: « Sun, 1 3 Apr 2003 22:34:46 
-1-0200 ». 


B 


Heure Internet Swatch : invention de la société Swatch selon laquelle 24 heures sont 
divisées en 1 000 éléments nommés « beats ». Par exemple, midi vaut 500 beats. 
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La fonction dateO pennet de récupérer des informations numériques individuelles en 
n'utilisant qu'un seul caractère dans la chaîne de formatage. 

Par exemple : 

I $numjour = dateC'w"); 

récupère le numéro du jour de la semaine, de 0 pour dimanche à 6 pour samedi ; 

I Snummoi s=date( "n" ) : 

récupère le numéro du mois de 1 à 12 ; 

I $bi ssext=date( "L" ) ; 

récupère la valeur 1 si l'année est bissextile et 0 dans le cas contraire. 
L'exemple ci-dessous : 

I$bissext=(bool) date("L"); 
if($bissext) {echo "L'année ".dateC'Y")," est bissextile";} 
else {echo "L'année ",date("Y")," n'est pas bissextile";) 

retourne le résultat suivant : 

L'année 2008 est bissextile 



La fonction getdateQ 

Contrairement à la fonction dateO, getdateO ne retourne pas une chaîne de caractères 
mais un tableau contenant toutes les informations de date. 

Sa syntaxe est la suivante : 

I array getdate([int timestamp] ) 

Si le paramètre timestamp est omis, la fonction getdateO retourne les informations sur la 
date en cours. 

Le tableau retourné est un tableau associatif, dont les clés sont fournies au tableau 8-2. 



Tableau 8-2 - Clés du tableau retourné par la fonction getdateQ 



Clé 


Description 




wday 


Le jour de la semaine sous forme d'entier de 0 (dimanche) à 6 (samedi) 




weekday 


Le jour de la semaine sous forme de chaîne (en anglais) 




mday 


Le jour du mois sous forme d'entier de 0 à 31 




mon 


Le mois sous forme d'entier de 1 à 12 




month 


Le mois sous forme de chaîne (en anglais) 




year 


L'année en entier sur 4 chiffres 




hours 


L'heure de 0 à 23 
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Tableau 8-2 - Clés du tableau retourné par la fonction getdateQ (suite) 



minutes 


Les minutes de 0 à 59 


seconds 


Les secondes de 0 à 59 


yday 


Le jour de l'année de 1 à 366 


0 


Le timestamp correspondant à la date 



La récupération des informations se fait en deux temps, l'appel de la fonction getdate( ) 
puis la lecture des éléments du tableau retourné. 

L'exemple ci-dessous : 

$jour = getdate( ) ; 

echo "Aujourd'hui {$jour["weekday"]} {$jojr["iiiday"]} {$jour["month"]) 
^{$jour["year"]}"; 

affiche le résultat suivant : 



Aujourd'hui Monday 20 October 2008 



Afficher la date en français 

Comme vous venez de le voir, les fonctions getdateO et dateO affichent les noms des 
jours et des mois en anglais. Une première manière d'obtenir un affichage en français 
consiste à utiliser ces fonctions d'une manière détournée. 

Vous créez pour cela deux tableaux indicés, Ssemai ne et $moi s, destinés à contenir respec- 
tivement les noms des jours et des mois en français. Pour un site multilingue, vous 
pouvez créer autant de tableaux que de langues désirées. Il vous suffit ensuite de récupé- 
rer les données numériques du jour de la semaine, avec dateC'j") ou $tab["wday"] si 
$tab=getdate( ), puis du numéro de mois, avec dateC'n") ou $tab["mon"], qui vous servi- 
ront d'indice pour lire le jour et le mois à partir des tableaux $semai ne et $moi s. 

Pour obtenir l'affichage suivant : 



Aujourd'hui Lundi 20 Octobre 



au lieu de « Monday 20 October », vous écrivez : 
$jour = getdate( ) ; 

echo "Aujourd'hui ", $semaine[$jour[ 'wday ' ]] , $jour["mday"] , 
^Snioi s[$jour[ 'mon ' ]] ,"<br>"; 

OU : 

\ echo "Aujourd'hui " ,$semaine[date( 'w' )] , date("d"), $mois[date( 'n ' )] ; 
echo $semaine[date( 'w' )] ,$moi s[date( 'n ' )] ; 
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L'exemple 8-5 donne l'ensemble du code nécessaire pour afficher une date en français 
avec les fonctions getdate( ) (repère Q) ^t date( )(repère ©). 

'■^ Exemple 8-5. Affichage d'une date en français avec date() et getdateO 

<?php 

//Date en français 
$jour = getdate( ) ; 

echo "Anglais: Aujourd'hui {$jour["weel<day"]} {$jour[''mday"]}{$jour["month"]) 
^{$jour["year"]} <br />"; 

$semaine = arrayC dimanche "," lundi "," mardi "," mercredi "," jeudi ", 
^" vendredi "," samedi "); 

Smois =array(l=>" janvier " , " février "," mars "," avril " , " mai "," juin ", 
juillet "," août "," septembre "," octobre "," novembre "," décembre "); 
//Avec getdate( ) 

echo "Français: Avec getdateO : Aujourd'hui ".SsemaineCSjourC'wday']] , 
^$jour[ 'mday ' ] , $mois[$jour['mon']], $jour[ 'year' ] , ''<br />";<— O 
//Avec dateO 

echo " Français: Avec dateO : Aujourd'hui ", $semaine[date( 'w' )] ," ", 

'•dateC 'j' )." ", $mois[date('n')]. date( ' Y ' ) . ''<br />":^© 

?> 

L'exemple retourne le résultat suivant : 



Anglais: Aujourd'hui Monday 20 October 2008 

Français: Avec getdateO : Aujourd'hui lundi 20 octobre 2008 

Français: Avec dateO : Aujourd'hui lundi 20 octobre 2008 

L'affichage de la date en français se retrouvant fréquemment sur toutes les pages d'un 
même site, il est dommage de réécrire le même code dans chaque page. Dans un but de 
modularisation du code, il est préférable de créer une fonction personnalisée. 

C'est l'objet de l'exemple 8-6, qui crée une fonction datefr( ) pour afficher le jour et le 
mois en français et un paramètre $njour pour afficher la date située un nombre de jours 
donné après la date en cours. Ce paramètre ayant par défaut la valeur 0, l'appel de 
datef r( ) sans paramètre affiche la date du jour. 

Exemple 8-6. Création d'une fonction de date en français 

<?php 

//Définition d'une fonction d'affichage en français 

function datef r($njour=0) 
{ 

$timestamp=time( ) + $njour*24*3600: 

$semaine = array(" dimanche " , " lundi "," mardi "," mercredi "." jeudi ", 
^" vendredi "," samedi "); 

Smois =array(l=>'' janvier " , " février "," mars "," avril " , " mai "," juin " , 
^" juillet "," août "," septembre " , " octobre "," novembre "," décembre "); 
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$chdate= $semaine[date( 'w' .Stimestamp)] ." " .date( ' j ' .Stimestamp) . " ". 
^$niois[date( ' n ' , $timestamp)] ; 
return Schdate; 

} 

?> 

Vous pouvez utiliser cette fonction dans n'importe quel script en l'incluant avec incl ude( ). 
Par exemple, le code suivant : 
<?php 

include("date8.6.php"); 

echo "Aujourd'hui : " .datef r( ) , "<br />"; 

echo "Dans 12 jours : ", datef r(45) , "<br />"; 

?> 

affiche, comme le script 8-5, le résultat suivant : 

Aujourd'hui : lundi 20 octobre 
Dans 45 jours : jeudi 4 décembre 



Proche de la fonction dateO par son fonctionnement, la fonction strftimeO permet 
d'afficher, en anglais, les informations de date composées à l'aide des caractères spéciaux 
du tableau 8-3. Sa syntaxe est la suivante : 

I string strftinie(string format_de_date. int timestamp) 



Tableau 8-3 - Caractères de formatage de la fonction strftimeO 



Caractère 


Description ~' 


%a 


Jour de la semaine abrégé 


%A 


Jour de la semaine en entier 


%b 


Mois abrégé 


%B 


Mois en entier 


%c 


Afficine la date et l'tieure au format local (exemple 24/ 04/2005 1 5:32:52 si la langue est le français). 


%C 


Numéro du siècle 


%d 


Jour du mois numérique de 01 à 31 


%D 


Équivalent de l'ensemble '%m%à%y' 


%e 


Jour du mois de 1 à 31 précédé d'une espace 


%h 


Équivalent de 


%H 


Nombre d'heures de 00 à 23 


%1 


Nombre d'heures de 00 à 1 2 (voir Xp pour afficher am ou pm) 


%i 


Numéro du jour de l'année de 1 à 366 


%m 


Numéro du mois de 1 à 12 
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Tableau 8-3 - Caractères de formatage de la fonction strftimeQ (suite) 





Nombre de minutes de 0 à 59 1 


%n 


Saut de ligne 


%p Affiche « am » ou « pm » selon l'heure j 


%S Nombre de secondes 




Fniilvalpnt fip |3 tahiilatinn l\ 

1 ULIIVuld II Uv7 lu IQUUIQLIUI 1 / L 


%J 


Fniiivalpnt dp rpn<^pmhlp "5;h ■ ■ 2!S " 


lu 


Le jour de la semaine de 1 pour lundi à 7 pour dimanche (attention cette notation est différente de 
celle des fonctions date et getdate). 


%U 


Numéro de la semaine (la première semaine commençant avec le premier dimanche de l'année, 
les jours qui précèdent ne comptent pas). 


%v 


Numéro de la semaine ISO de 01 à 53. La première semaine est celle qui a plus de 4 jours ; le lundi 
est le premier jour de la semaine. 


%w 


Le jour de la semaine de 0 pour dimanche à 6 pour samedi 


%U 


Numéro de la semaine (la première semaine commençant avec le premier lundi de l'année, les 
jours qui précèdent ne comptent pas). 


Ix 


Affiche la date au format local défini par setl ocal e( ). Exemple JJ/ MM/AAAA. 


%X 


Affiche l'heure au format local défini par setlocale( ). Exemple HH:MM:SS. 


%y L'année sur deux chiffres de 00 à 99 


11 


L'année sur quatre chiffres 


11 


Les villes correspondant au fuseau horaire 


11 Affiche le caractère « % » seul. 



La fonction gmstrftimeO fournit les mêmes résultats en heure GMT. Pour afficher l'équi- 
valant de ces dates en français (ou dans une autre langue), il suffit d'utiliser auparavant la 
fonction setl ocal eO selon la syntaxe suivante : 

I string setlocalednt constante, string lang) 

La constante prend les valeurs LC_ALL ou LC^TIME dans le contexte temporel et pour para- 
mètre 1 ang le code de la langue désirée, par exemple "f r" pour le français. 

Pour adapter automatiquement l'affichage de la date à la langue du navigateur, qui n'est 
pas forcément celle du pays, vous pouvez récupérer ce paramètre de langue à l'aide de la 
variable $^SERVER["HTTP_ACCEPT_LANGUAGE"]. 

L'exemple 8-7 utilise cette propriété pour afficher la date en français puis en italien après 
avoir configuré le navigateur dans cette langue. L'utilisation conjointe des fonctions 
strftimeO et setl ocal eO est très pratique, mais il vous appartient de vérifier qu'elles 
marchent sur votre serveur distant, en particulier la fonction setl ocal eO, car ce n'est pas 
toujours le cas. 
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La langue est d'abord définie avec le paramètre "f r" (repère O)- Le script affiche ensuite 
en français la date complète en heure locale (repère ©) puis en GMT (repère 0). La 
variable $1 an g récupère la valeur prioritaire du navigateur (repère O), puis l'affichage se 
fait en italien (repère 0). 

Exemple 8-7. Affichage de la date avec setlocaleO et strftimeO 

<?php 
/ 

//Avec setlocaleO et strftimeO 

echo "fonction strftimeO et setlocaleO <br />"; 
setlocale (LC_ALL, "fr"):<-0 

echo "Français : Aujourd' hui " .strftime( " ^A Xd %5 h %M m s %Z".time()). 

*»'"<br />": ^0 

echo "Français GMT : Aujourd' hui " .gmstrftime( " U %d %B 11 %W \\ %V\ m %S s %1\ 
^timeO)."<br />"; ^© 

$lang = $_SERVER["HTTP_ACCEPT_LANGUAGE"] ; <-© 
echo "Langue utilisée par le navigateur = ",$lang,"<br />": 
setlocale (LC_ALL. Slang); 

echo "Italiano : ",strftime(" ^A lA %B %Y %H h %M m %S s" ,time( ) ) , "<br />":<-© 
?> 

Le script retourne le résultat suivant : 
Fonctions strftimeO et setlocaleO 

Français : Aujourd'hui vendredi 24 octobre 2008 23 h 53 m 46 s Paris, Madrid (heure 
d'été) 

Français GMT : Aujourd'hui vendredi 24 octobre 2008 21 h 53 m 46 s Paris, Madrid 
Langue utilisée par le navigateur = it,fr;q=0.5 
Italiano : venerdi 24 ottobre 2008 23 h 53 m 46 s 



Les fonctions de calendrier 

L'extension nommée calendar installée par défaut dans PHP propose quelques autres 
fonctions, plus anecdotiques que les précédentes, comme la fonction easter_date( ), qui 
retourne le timestamp du jour de Pâques de l'année passée en paramètre et dont la 
syntaxe est la suivante : 

I int easter_date(int année) 

Cette fonction permet de fabriquer un calendrier complet pour une année donnée, les 
autres fêtes religieuses des mois suivants étant calculées par rapport à la date de Pâques, 
ou encore de prévoir vos week-ends des années futures. 

En écrivant, par exemple : 

I echo "Pâques 2009 sera le : ",date( "d F Y", easter_date(2009)) ; 
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vous obtenez l'affichage suivant : 



Pâques 2009 sera le : 12 April 2009 



Le calendrier actuel, dit grégorien, a été instauré en 1582 en Europe continentale et 
en 1753 au Royaume-Uni et dans le Commonwealth. Auparavant, c'était le calendrier 
Julien, instauré par Jules César, qui gouvernait le temps. L'usage de ces calendriers 
permet de gérer des dates antérieures à l'epoch UNIX (origine des timestamps au 
1«' janvier 1970). 

Pour contourner le problème de non-prise en charge d'une date antérieure à 1970 sous 
Windows, par exemple, vous pouvez utiliser des fonctions qui font appel au calendrier 
Julien. La fonction gregoriantojd( ), dont la syntaxe est la suivante : 

I int gregori antojd ( int mois, int jour, int année) 

retourne le nombre de jours du calendrier Julien. Utilisée comme paramètre pour d'autres 
fonctions, elle se révèle fort utile. 

L'exemple suivant : 

I divers jddayofweek ( int jour_julien, int mode) 

retourne le jour de la semaine sous la forme d'un entier de 0 (dimanche) à 6 (samedi) si 
le paramètre mode vaut 0 et sous la forme d'une chaîne de caractères en anglais s'il vaut 1. 
Cette fonction vous permet, comme à l'exemple 8-8, de connaître la date de naissance 
d'une personne née avant le P"^ janvier 1970 ou le jour d'un événement historique dont 
vous saisissez le jour du mois, le mois et l'année dans un formulaire (repères 0> 0 st 0). 
Dans cet exemple, vous utilisez en outre un tableau pour traduire les jours de la semaine 
en français (repère 0). 

'■^ Exemple 8-8. Recherche d'un jour de semaine antérieur à 1970 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/TR/html4/strict.dtd"> 

<htnil> 

<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r'> 

<title>Quel jour c'était?</title> 

</head> 

<body> 

<hl> Quel jour c'était? </hl> 

<form method="post" action="<?= $_SERVER["PHP_SELF"] ?>" > 
<fieldset> 

<legend>Quel jour c'était? </legend> 

Jour   <input type="text" name="jour" /><br><— © 
Mois  <input type="text" name="mois" /><br><— © 
Année<inpLit type="text" name="an" /><br> <— © 
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<input type="subniit" nanie="envoi " value="Calculer"/><br> 

</fieldset> 

</forin> 

<?php 

//Utiliser un formulaire de saisie de date et donner le jour de la semaine 

if(isset($_POST["envoi"])) 

{ 

//Récupération des valeurs 
$jour= $_POST["jour"] : 
$mois= $_POST["moi s"] : 
$an= $_POST["an"]: 
//Transformation Grégorien/Jul ien 
$jd = gregoriantojd{$mois,$jour,$an) : 
//Traduction en français 

$semaine = arrayC "Sunday"=>" dimanche " , "Monday"=>" lundi " , "Tuesday"=>" mardi 
^"Wednesday"=>" mercredi " , "Thursday"=>" jeudi " , "Friday"=>" vendredi 
*"Saturday"=>" samedi ");<— O 

//Affichage du résultat 

echo "<h2>Le $jour/$mois/$an était un " ,$semaine[jddayofweek($jd ,1)] , "</h2>" ; 
} 

?> 

</body> 
</html> 



^ Quel jour c'était? - Hictocoft Internet Exploiei B@S 



ricliiei Cifiicn AHïcIiage Favoris Outls ? /' 

Trécédeiile - Q ^ necheichet 'jj^' favoiis Média Liîns 

Adr.;Mc ^iUp:>'/l27.0,0.1/plip5/<:0datai/Jala0.0.plip OK 



Quel jour c'était? 

Quel jour c'était? 

Joui- | 2 I 
Mois fÏ2 I 
Aancc|l 804 | 
IPgjcûiëF'll 



Le 2/12/1804 était un dimanche 



Tominé 49 Internet 

Figure 8-2 

Calcul d'un jour de semaine antérieur à 1970 

D'autres fonctions anecdotiques fournissent les mois des calendriers julien, juif ou révo- 
lutionnaire, qui permettent de comprendre, par exemple, pourquoi la révolution russe. 
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dite d'octobre 1917 dans le calendrier Julien en vigueur alors en Russie, a eu lieu en 
novembre dans le calendrier grégorien en vigueur en France, ou de savoir quel jour a eu 
lieu le coup d'État de Bonaparte le 18 Brumaire an VIII (9 novembre 1799) ou la chute 
de Robespierre le 9 Thermidor an II (27 juillet 1794). 



Mémo des fonctions 

bool checkdate (int mois, int jour, int année) 

Vérifie la validité de la date définie à l'aide des paramètres moi s, jour, année. 

string date(string format, int timestamp) 

Retourne en clair la date composée des informations indiquées dans la ctiaîne de formatage (voir le tableau 8-1). 
array getdate(int timestamp) 

Retourne un tableau associatif contenant toute information de date correspondant au timestamp (voir le tableau 8-2). 
array gettimeofday( ) 

Retourne un tableau associatif dont les clés sont sec, usée, minuteswest et dsttime correspondant respectivement au 
nombre de secondes et de microsecondes et au décalage fioraire par rapport à l'fieure GMT. L'élément de clé dsttime 
vaut 1 pour l'fieure d'hiver et 0 en été. Les valeurs sont celles du serveur. 

string gmdate(string format, int timestamp) 

Identique à la fonction date( ) mais avec des données GMT 

int gmmktime(int heure, int minute, int seconde, int mois, int jour, int année, int hiver) 

Retourne le timestamp GMT correspondant à l'instant défini parles paramètres. L'entier hiver vaut 1 pour l'heure d'hiver 
et 0 sinon. 

string Gmstrftime(string format, int timesatmp) 
Identique à strftime( ) mais en heure GMT 
string microtime( ) 

Retourne une chaîne composée du nombre de microsecondes suivi d'une espace puis du nombre de secondes de 
l'instant présent. 

int mktime(int heure, int minute, int seconde, int mois, int jour, int année, int hiver) 

Retourne le timestamp (en heure locale du serveur) correspondant à l'instant défini par les paramètres. L'entier hiver 
vaut 1 pour l'heure d'hiver et 0 sinon. 

string Strftime(string format, int timestamp) 

Retourne un tableau associatif contenant toutes les informations de date correspondant au timestamp (voir le tableau 8-3). 
int timeO 

Retourne le timestamp de l'instant en cours sur le serveur. 
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Exercices 

Exercice 1 

Après avoir consulté le résultat affiché par l'exemple 8-1, déterminez la date et l'heure de 
l'exécution de ce script. 

Exercice 2 

Calculez votre âge à l'instant en cours à la seconde près. 
Exercice 3 

Vérifiez si la date du 29 février 1962 a existé. 
Exercice 4 

Quel jour de la semaine était le 3 mars 1993 ? Affichez le résultat en français. 
Exercice 5 

Affichez toutes les années bissextiles comprises entre 2005 et 2052. 
Exercice 6 

Déterminez quel jour de la semaine seront tous les premier Mai des années comprises 
entre 2005 et 2010. Si le jour est un samedi ou un dimanche, affichez le message 
« Désolé !». Si le jour est un vendredi ou un lundi, affichez « Week-end prolongé !». 

Exercice 7 

L'Ascension est le quarantième jour après Pâques (Pâques compris dans les 40 jours). 
Calculez les dates de l'Ascension pour les années 2005 à 2010. 



9 

La programmation objet 



Avant la version 5, PHP était loin d'être un langage de programmation orientée objet 
(POO), en comparaison de Java ou de C++, dont, il est vrai, la destination n'est pas la 
même. Dans ASP.Net, destiné typiquement au Web, toute action de programmation 
entraîne la création et la manipulation d'objets préexistants. Du fait de cette lacune de 
PHP 4, les projets de grande envergure le délaissaient au profit d'ASPNet ou de JSP 

Les concepteurs de PHP 5 ont dû effectuer une refonte totale du modèle objet très 
sommaire de PHP 4 pour le rendre plus proche de celui de Java. Sans devenir un langage 
de POO à part entière, PHP 5 fournit néanmoins désormais les outils nécessaires à ceux 
qui souhaitent choisir cette orientation. La manipulation d'objets n'est pas une obligation 
dans le plupart des cas mais pourrait devenir une nécessité pour de gros projets. 

D'ores et déjà, l'extension SimpleXML, qui permet de gérer les documents XML (voir le 
chapitre 19) ne fournit qu'une approche objet et aucune fonction, contrairement aux autres 
extensions. De son côté, la base SQLite est certes encore accessible via une méthode 
procédurale, mais elle offre en parallèle un accès orienté objet, dont l'utilisation est 
recommandée. MySQL est également engagé dans cette voie. C'est donc une tendance 
lourde de PHP 5. Même si on peut en discuter, il paraît évident qu'elle ne fera que 
s'accentuer. 

Ce chapitre aborde non pas l'utilisation d'objets prédéfinis mais l'ensemble des outils 
qui permettent au programmeur de créer ses propres objets. 

De même que vous écrivez une fonction pour effectuer une tâche répétitive, vous avez un 
intérêt à créer des objets pour gérer des projets complexes. Un objet correspond à la modé- 
lisation d'une entité réelle ou abstraite, par exemple, un client, l'article qu'il commande 
ou la commande elle même. La POO permet de modulariser le code des scripts en décom- 
posant les données à traiter en différentes entités, chacune étant représentée par un type 
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d'objet. Elle offre de surcroît la possibilité de réutiliser des classes déjà créées grâce au 
mécanisme de l'héritage, qui permet de créer de nouvelles classes à partir des classes 
existantes en leur ajoutant de nouvelles fonctionnalités. 

Il ne s'agit pas ici, en un seul chapitre, d'aborder tous les aspects de la POO. Si vous 
voulez approfondir vos connaissances sur le sujet, vous pourrez vous reporter utilement 
au livre de Bertrand Meyer, Conception et programmation orientées objet, aux éditions 
Eyrolles, qui constitue la bible sur le sujet. 

Terminologie des objets 

Si vous avez déjà pratiqué d'autres langages de programmation réellement orientés objet, 
les notions de classe et d'objet vous sont familières. Vous pouvez donc passer directement 
à la section suivante, qui vous permettra de voir la manière d'implémenter les classes et 
les objets dans PHP. 

La terminologie propre aux classes et aux objets est très variable selon les sources. Pour 
cette raison, il apparaît utile de préciser le vocabulaire qui sera employé dans ce chapitre. 

Un objet informatique est la représentation d'un objet réel au sens large. Il peut aussi 
bien s'agir d'un produit commercial, d'une personne ou d'un bon de commande. Le 
travail d'analyse du programmeur consiste dans un premier temps à dégager les diffé- 
rents types d'objets qui interviennent dans son application et leurs interactions. Il lui faut 
ensuite décrire les caractéristiques communes à chaque type d'objet. 

Chaque client d'un site de commerce en ligne, par exemple, a un nom, un prénom, une 
carte bancaire, une adresse, etc., mais chaque personne est différente. Quand vous modé- 
lisez un objet, ses caractéristiques sont nommées champs, attributs, membres ou propriétés, 
selon les auteurs. De même, un objet modélisé peut réaliser des actions. Une personne 
vue sous l'angle client peut effectuer les actions «commander», «déménager» ou 
« payer ». Ces actions, représentées par des fonctions, sont généralement nommées 
méthodes ou fonctions propres. Elles permettent d'agir sur les propriétés de l'objet. Vous 
utiliserez ici, une fois n'est pas coutume, le vocabulaire rencontré dans tous les outils de 
programmation Microsoft, qui consiste à définir un objet par ses propriétés et méthodes. 
Ce vocabulaire est également employé dans JavaScript. 

Une fois les différents types d'objets d'une application dégagés, leur représentation 
informatique abstraite est décrite dans une classe, aux moyens de variables, qui représen- 
tent les propriétés des objets, et de fonctions, qui représentent les méthodes. Ces variables 
et fonctions sont propres à la classe et ne devraient généralement être accessibles qu'aux 
objets. C'est ce que l'on nomme l'encapsulation des données. Par abus de langage, vous 
rencontrerez les termes « propriétés » et « méthodes » pour une classe, alors qu'elle 
contiendra des variables et des fonctions. La classe est donc le niveau d'abstraction le 
plus élevé pour la représentation d'une famille d'objets. En langage courant, on pourrait 
dire que la classe est le moule général, relativement flexible, permettant la fabrication 
d'autant d'objets que désiré, objets du même type, mais pas nécessairement identiques. 
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Le concept de classe 

Pour les amateurs de mathématiques, le concept de classe utilisé ici se rapporte à celui de classe d'équi- 
valence pour une relation donnée. 

Un objet est un représentant de la classe à partir de laquelle il est créé. On dit qu'il est une 
instance de cette classe. L'objet créé a des propriétés correspondant aux variables de la 
classe et des méthodes qui correspondent aux fonctions de la classe. Il se distingue des 
autres objets grâce aux valeurs de ses propriétés. Si la classe représente un client humain, 
elle peut avoir quelque six milliards d'instances, toutes différentes. 

Le mode opératoire d'utilisation des classes et des objets dans PHP 5 doit respecter les 
étapes suivantes : 

1. Créez une classe de base pour l'objet. Elle doit avoir autant de variables que vous 
désirez de propriétés pour l'objet. Elle contient les fonctions qui permettent d'agir sur 
les propriétés. 

2. Créez autant d'objets que nécessaire à partir du modèle défini par la classe. 

3. Définissez une valeur particulière pour une ou plusieurs des propriétés de chaque 
objet que vous venez de créer. Vous verrez que cette définition peut aussi se faire lors 
de la création de l'objet à l'aide d'un constructeur. 

4. Utilisez les objets et manipulez -les, généralement à l'aide des méthodes définies dans 
la classe. 



Classe et instance 

Les opérations de base pour l'utilisation des objets sont la création d'une classe et la défi- 
nition de ses propriétés et des méthodes qui vont permettre aux objets créés à partir de la 
classe d'agir sur leurs propriétés ou de communiquer avec leur environnement. Vient 
ensuite la création des objets proprement dits en tant qu'instances de la classe de base. 

Création d'une classe 

Pour créer une classe avec PHP 5, procédez de la façon suivante : 

1. Déclarez la classe à l'aide du mot-clé cl ass suivi du nom que vous souhaitez lui attri- 
buer. 

2. Ouvrez un bloc de code à l'aide d'une accolade ouvrante contenant l'intégralité de la 
définition de la classe. 

3. Déclarez les variables propres de la classe comme des variables ordinaires, avec les 
mêmes règles de nommage et le caractère $ obligatoire. Chaque variable doit être 
précédée d'un modificateur d'accès précisant les possibilités d'accès à sa valeur. 
Nous reviendrons sur les choix possibles. Dans un premier temps, faites précéder 
chaque variable du mot-clé public. Les variables peuvent être initialisées avec des 
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valeurs de n'importe quel type reconnu par PHP. En particulier, une variable peut être 
utilisée comme un tableau créé à l'aide de la fonction array( ). L'utilisation d'autres 
fonctions PHP ou d'expressions variables est en revanche interdite pour affecter une 
valeur à une variable. Le nombre de variables déclarées dans une classe n'est pas 
limité. 



Le mot-clé var 

Dans PHP 4, les variables de classe devaient être précédées du mot-clé var. Il est toujours possible de 
l'employer, mais c'est déconseillé dans PHP 5. Dans PHP 4, l'absence du mot-clé var provoque immédia- 
tement une erreur fatale et l'arrêt du script. 



4. Déclarez les fonctions propres de la classe en suivant la même procédure que pour les 
fonctions personnalisées à l'aide du mot-clé function, précédé, comme les variables, 
d'un spécificateur d'accès (par défaut le mot-clé public). Le nom des fonctions 
propres ne doit pas être le même que celui de la classe qui les contient, faute de quoi 
la fonction concernée aura un rôle particulier, comme vous le verrez ultérieurement 
dans ce chapitre. Il ne doit pas non plus commencer par deux caractères de souligne- 
ment ( ), cette notation étant réservée à certaines fonctions particulières de PHP 5. 

5. Terminez le bloc de code de la classe par une accolade fermante. 



Attention 

Le bloc de code de la classe ne doit rien comporter d'autre que ce qui est indiqué ci-dessus. En particulier, 
il ne doit contenir aucune fonction ou instruction PHP située en dehors des fonctions propres de la classe 
ou de la déclaration des variables. 



L'ensemble de ces étapes est résumé dans la syntaxe générale de création d'une classe de 
l'exemple 9-1. 

PHP 5 permet de définir des constantes propres à la classe à l'aide du mot-clé const suivi 
du nom de la constante puis de sa valeur. Ces constantes peuvent avoir le même nom que 
d'autres qui auraient été définies en dehors d'une classe avec la fonction defineO. En 
contrepartie, elles ne sont pas accessibles à l'extérieur de la classe avec leur seul nom 
(voir plus loin la notation ::). 

f*" Exemple 9-1 . Création d'une classe type 

<?php 

class nia_classe 
{ 

//Définition d'une constante 

const lang="PHP 5"; <— O 

//Définition des variables de la classe 

public Spropl; <— 0 

public $prop2 =''valeur'' ; <— © 

public $prop3 = array( "val eurO" , "val eurl" ) ; <— © 

//Initialisation interdite avec une fonction PHP 
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//public $prop4= dateC d : m : Y"); Provoque une erreur fatale 

//Définition d'une fonction de la classe 

public function n)a_fonction($paraml ,$parainN) <— 0 

{ 

//Corps de la fonction 

} 

} 

//fin de la classe 
?> 

Dans ce code, la variable $propl est déclarée mais pas initialisée (repère Q)' 1^ variable 
$prop2 est déclarée et initialisée avec une valeur de type s t ring (repère 0), et la variable 
$prop3 est un tableau initialisé en utilisant la fonction array( ) (repère 0). 

La classe contient de plus une fonction nommée ma_fonction( ) déclarée public, qui a la 
structure habituelle d'une fonction personnalisée et dont le corps peut utiliser des appels 
de fonctions natives de PHP. 

L'exécution de ce code ne provoque aucun résultat visible, comme il se doit. 

L'exemple 9-2 présente la création d'une classe représentative d'une action boursière 
contenant des informations générales sur chaque action. La classe étant un modèle géné- 
ral, elle peut s'appliquer à toutes les actions cotées, quelle que soit la Bourse concernée. 
Vous l'enrichirez par la suite avec d'autres propriétés et d'autres méthodes que celles de 
la classe d'origine. La classe nommée action contient une constante nommée PARIS défi- 
nissant l'adresse de la Bourse de Paris (repère Q)' deux variables non initialisées, $nom 
(repère 0), qui contiendront l'intitulé de l'action boursière, et $cours (repère ©), qui en 
contiendra le prix, ainsi qu'une variable Sbourse initialisée à la valeur "Bourse de Paris", 
qui représentera la place boursière par défaut (repère Q). 

Chaque variable peut donc avoir une valeur par défaut définie dans la classe de base, 
mais la valeur de chacune des propriétés reste entièrement modifiable pour chaque objet 
créé à partir de la classe, comme vous le verrez par la suite. 

La classe action contient également une fonction propre définie par infoO, qui, selon 
l'heure d'exécution du script et le jour de la semaine, indique si les bourses de Paris et de 
New York sont ouvertes ou non (repère 0). Cette fonction n'utilise pour l'instant aucune 
des variables de la classe. 

Exemple 9-2. Création d'une classe action 

<?php 

class action 
{ 

//Constante 

const PARIS="Palais Brognard":^0 

//variables propres de la classe 
publ ic $noin: <— © 
public $cours; <— 0 

public $bourse="bourse de Paris " ; <— O 
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//fonction propre de la classe 
public function 1nfo()<— @ 
{ 

echo "Informations en date du " ,date( "d/m/Y H: i :s" ) , "<br>" ; 

$now=getdate( ) ; 

$heure= $now["hours"] ; 

$jour= $now["wday"] ; 

echo "<h3>Hora1 res des cotations</h3>" ; 

if(($heure>=9 && $heure <=17)&& ($jour!=0 && $jour!=6)) 

{ echo "La Bourse de Paris est ouverte <br>"; } 

el se 

{ echo "La Bourse de Paris est fermée <br>"; ) 
if(($heure>=16 && $heure <=23)&& ($jour!=0 && $jour!=6) ) 
{ echo "La Bourse de New York est ouverte <hr>"; ) 
el se 

{ echo "La Bourse de New York est fermée <hr>"; } 

} 

} 

?> 

Le rôle de la POO étant de créer des bibliothèques de classes réutilisables par n'importe 
quel script, enregistrez le code de la classe action dans un fichier séparé. Pour l'utiliser, 
créez un fichier séparé (l'exemple 9-3) destiné à utiliser cette classe en incorporant son 
code à l'aide de la fonction requi re( ). Cette pratique est fortement recommandée. 

Exemple 9-3. Tentative d'utilisation de la classe action 

<?php 

requi re("objet2. php" ) : <— O 

echo "Constante PARIS =". PARIS, "<br />";<—© 

echo "Nom = ".$nom,"<br />"; <— 0 

echo "Cours= " , $cours . "<br />";<—© 

echo "Bourse^ " ,$bourse, "<br />";<—© 

//infoO; //L'appel de info( )Provoque une erreur si vous décommentez la ligne 

action: :info();//fonctionne O 

echo "Constante PARIS =", action: :PARIS,"<br />";<—© 

?> 

Le résultat obtenu est le suivant : 



Constante PARIS =PARIS 

Nom = 

Cours= 

Bourse^ 

Informations en date du 01/02/2009 22:20:22 

Horaires des cotations 

La Bourse de Paris est fermée 

La Bourse de New York est fermée 

Constante PARIS =Pala1s Brognard 
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Le code définissant la classe incorporée à l'exemple 9-3 (repère Q) ^st bien une entité à 
part entière dans celui du script. En effet, vous constatez en exécutant le script que les 
variables et les fonctions créées dans le corps de la classe ne sont pas accessibles dans le 
reste du code du script, même si elles se situent après la définition de la classe. La tenta- 
tive d'affichage de la constante (repère 0) et des variables de la classe (repère 0, O ^t 
0) ne produit aucun affichage. Cela n'a rien d'exceptionnel pour les variables $nom et 
$cours, puisqu'elles sont vides, mais est plus significatif pour la variable Sbourse, car 
vous lui avez attribué une valeur lors de sa déclaration. 

Pire encore, si vous tentez d'utiliser la fonction infoO de la classe action comme une 
fonction ordinaire (repère ©), vous obtenez pour toute réponse le triste message suivant : 



"Fatal error: Call to undefined function infoO in c:\wamp5\www\php5\C9objets\ 
objets. php on line 7 " 

Cela vous indique que PHP ne reconnaît pas la fonction appelée et qu'il la considère 
comme non déclarée. Pour pouvoir l'utiliser en dehors de la création d'un objet instance 
de la classe action, il vous faut faire appel à la syntaxe particulière suivante : 

I noin_cl asse: :noni_fonction( ) ; 

en précisant éventuellement ses paramètres, s'ils existent. Cela vous permet d'utiliser les 
fonctions propres d'une classe en dehors de tout contexte objet si elles sont déclarées 
publ i c. Dans l'exemple 9-3, en écrivant en fin de script (repère Q) le code suivant : 

I action: :info( ) ; 

vous obtenez bien les informations que fournit l'exécution de la fonction infoO, sans 
avoir créé le moindre objet. 

De même, vous pouvez accéder à la constante définie dans la classe en utilisant la même 
syntaxe en dehors de la classe (repère 0) : 

I echo "Constante PARIS =" .action: :PARIS, "<br />"; 

qui affichera bien « Palais Brognard ». 

Dans la pratique professionnelle, vous avez toujours intérêt à séparer en deux fichiers 
distincts le code de création des classes et celui qui les utilise. Cela vous permet de réuti- 
liser la même classe dans plusieurs scripts sans avoir à recopier le code de chacun d'eux. 



Créer un objet 

Vous venez de voir comment créer une classe, mais votre script ne dispose d'aucune 
fonctionnalité ni variable supplémentaire, ce qui a toutes les chances de produire un 
résultat décevant. En reprenant l'analogie avec un moule, il vous faut maintenant utiliser 
le moule constitué par la classe pour créer des objets. 

Chaque objet créé à partir de votre classe est appelé une instance de la classe. A chaque 
instance correspond un objet différent. Un objet particulier est identifié par un nom de 



244 



PHP 5 



variable tel que vous avez désormais l'habitude d'en écrire et est créé à l'aide du mot-clé 
new selon le modèle suivant : 

I $var_objet = new nom_classe() 

Prenez soin que le code de définition de la classe soit dans le même script ou soit inclus 
au début du script à l'aide des fonctions requireO ou includeO. 

A partir de maintenant, le script possède une variable $ va r_ob j et qui a les propriétés et les 
méthodes définies dans la classe de base. 

Vous pouvez le vérifier en écrivant : 
^ echo gettype($var_objet) 

La valeur retournée par cette fonction est bien object, vous confirmant s'il en était besoin 
que la variable est d'un type nouveau par rapport à celles couramment utilisées jusqu'ici. 

Le nom de la classe n'a pas besoin d'être défini par une expression explicite, comme 
vous venez de le faire, mais peut être contenu dans une variable chaîne de caractères. 

La syntaxe suivante : 

|$maclasse ="nom_cl asse" ; 
$var_objet = new $maclasse(); 

crée une instance de la même classe que le code précédent ce qui offre la possibilité de 
créer des objets dynamiquement, en fonction des saisies d'un visiteur du site par exemple. 

Pour créer des objets représentant des actions boursières conformes au modèle de votre 
classe action, vous écrivez donc : 

I$actionl = new actionO; 
$action2 = new actionO; 

II est possible de vérifier si un objet particulier est une instance d'une classe donnée en 
utilisant l'opérateur instanceof pour créer une expression conditionnelle, selon la syntaxe 
suivante : 

I if($objet instanceof noin_classe) echo "OK"; 

II vous faut maintenant personnaliser vos objets afin que chacun d'eux corresponde à une 
action boursière particulière. Vous agissez pour cela sur les propriétés d'un objet que 
vous venez de créer afin de le distinguer d'un autre objet issu de la même classe. 

Pour accéder, aussi bien en lecture qu'en écriture, aux propriétés d'un objet, PHP offre la 
syntaxe particulière suivante, propre aux variables objets. Pour utiliser la propriété décla- 
rée dans la classe par $prop, appliquez la notation -> (caractère moins suivi du signe supé- 
rieur à) sous la forme : 

I $nom_objet->prop: 

ou encore : 

I $nom_objet->prop[n] ; 

si la propriété prop de l'objet est un tableau. 
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Pour appeler une méthode de l'objet, appliquez la même notation : 
I $nom_objet->nom_fonction( ) ; 



Risque d'erreur 

Ici, la variable est l'objet, et il n'y a jamais de signe $ devant le nom de la propriété. Par contre, les paren- 
thèses et les paramètres éventuels de la méthode sont indispensables. 



Vous pouvez afficher sa valeur ou lui en affecter une autre. Par exemple, pour afficher la 
valeur de la propriété bourse d'un objet de type action, vous écrivez : 

I echo $actionl->bourse: 

qui affiche la valeur par défaut « Bourse de Paris » définie dans la classe. 

Pour lui affecter une nouvelle valeur, vous avez le code : 

I $actionl->bourse = "New York"; 

Pour appeler la seule méthode de l'objet : 

I $actionl->infD( ) 



IVIodlfications et classe de base 

La variable Sbourse de la classe action a toujours la valeur Bourse de Paris. N'importe quelle 
nouvelle instance de la classe crée un objet qui aura encore cette valeur par défaut pour la propriété 
bourse. En règle générale, les modifications opérées sur un objet n'ont aucun effet sur la classe de base 
de l'objet. 



L'exemple 9-4 donne une illustration de la création d'objets à partir de la classe action 
puis de la définition des propriétés et enfin de l'utilisation de ces propriétés pour un affi- 
chage d'informations. 

'■^ Exemple 9-4. Création et utilisation d'objets 

<?php 

requ1re("objet2.php") : <— O 

//Création d'une action 
$actionl= new action();<— © 
//Affectation de deux propriétés 
$actionl->nom = "Mortendi " ; ^0 
$actionl->cours = 15.15; <— O 
//Utilisation des propriétés 

echo "<b>L'action $actionl->noni cotée à la $actionl->bourse vaut $actionl->cours 
^&euro:</b><hr>": <-0 
//Appel d'une méthode 
$actionl->info( ) ; <— © 

echo "La structure de l'objet \$actionl est : <br>": 
var_dump($actionl) ; <— © 
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echo "<h4>Descriptif de 1 'action</h4>" ; 
foreach($actionl as $prop=>$val eur) <— 0 
{ 

echo "$prop = $valeur <br />"; 

} 

if($actionl instanceof action) echo "<hr />L'objet \$actionl est du 

*type action"; <— © 

?> 

Le code de la classe action est incorporé à l'aide de la fonction requireC ) (repère O). 
Vous créez ensuite une variable $actionl représentant un objet de type action et définis- 
sez des valeurs pour les propriétés nom et cours (repères Q et ©). Ces propriétés sont lues 
et utilisées pour créer un affichage (repère 0). L'appel de la méthode de l'objet permet 
d'obtenir des informations sur l'ouverture des bourses (repère©). La fonction var„ 
dumpO permet d'afficher, à l'usage du programmeur uniquement, le nom, le type et la 
valeur de chaque propriété (repère Q). 

Plus élégamment, vous pouvez lire l'ensemble des propriétés de l'objet Sactionl à l'aide 
d'une boucle foreach (repère 0). L'utilisation de l'opérateur instanceof vous permet de 
vérifier que l'objet est bien une instance de la classe action. 

La figure 9-1 donne le résultat du script. 



Ëçhier Édition Affichage Hîstonque Marque-pages Outils : 

c 



http://locaihf»t/chsp9/objct4.php 



ù 



jl"! Google 



L'action Mortendi cotée à la bourse de Paris vaut IS.IS € 



Informations en date du 02/02/2009 09:52:30 

Horaires des cotations 

La Bourse de Paris est ouverte 

La Bourse de New York est fermée 



La structure de l'objet Sactionl est : 

object(action)#l (3) { ["nom"]=> string(8) "Mortendi" ["cours"]=> float(15.15) ["bourse"]=> string(16) "bourse de Paris " } 

Descriptif de l'action 

nom = Mortendi 

cours = 15.15 

bourse = bourse de Paris 



L'objet Sactionl est du type action 



Figure 9-1 

Affichage des propriétés d'un objet 
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Accès aux variables de la classe 

Comme vous venez de le voir, les variables propres de la classe ne sont pas accessibles 
directement à l'extérieur du code qui définit la classe. Il est donc possible d'utiliser dans 
le script des variables qui ont les mêmes noms sans risquer de modifier les valeurs de 
celles de la classe. De même, l'accès habituel aux méthodes est impossible directement 
de l'extérieur de la classe. Cette particularité est nommée encapsulation et permet en 
quelque sorte de protéger la « cuisine » interne que vous avez conçue pour créer une 
classe. 

De la même façon, si vous essayez d'utiliser dans une méthode une variable déclarée de 
la classe, vous n'obtenez aucun résultat. 



Variables globales et superglobales 

Il est possible d'utiliser dans une fonction propre une variable globale du script à l'aide du mot-clé gl obal 
(voir l'exemple 9-5). Les variables superglobales de type array, par exemple $_POST, sont directement 
accessibles dans le corps d'une méthode. 



Pour accéder à une constante de classe dans le corps d'une fonction, utilisez la syntaxe 
particulière suivante : 

I sel f : imaconstante 

ou encore : 

I nomclasse: imaconstante 

Pour accéder à cette constante à l'extérieur de la classe vous pouvez également utiliser 
cette dernière notation et, depuis PHP 5.3, la syntaxe suivante : 

|$cl asse="noiïicl asse" ; 
echo Sciasse: imaconstante; 

Pour qu'une méthode accède aux variables déclarées dans la classe, elle doit y faire appel 
à l'aide de la syntaxe suivante : 

I $thi s->mavar 

dans laquelle la pseudo-variable $th1s fait référence à l'objet en cours, ce qui permet 
d'utiliser la variable $mavar dans la méthode. La méthode infoO de votre classe action 
peut maintenant être enrichie et avoir comme fonctionnalité supplémentaire d'afficher 
toutes les caractéristiques d'un objet action. 

Vous pouvez, par exemple, remplacer la ligne de code : 

Iecho "<b>L'action $actionl->nom cotée à la bourse de $actionl->bourse 
^vaut $actionl->cours _</b><hr>": 

de l'exemple 9-4 par le code suivant, qui fera partie du corps de la fonction info( ) : 
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if (isset($this->nom) && isset($this->cours)) 
{ 

echo "<b>L'action $this->noni cotée à la bourse de {$thi s->bourse[0] } 
'•vaut $this->cours €</b><br />";//9 

} 

La vérification de l'existence des variables permet de bloquer l'affichage dans le cas où 
aucun objet n'a été créé, sans pour autant empêcher l'appel de la fonction infoO. La 
gestion de cet affichage est transférée à une méthode d'objet et ne figure plus dans le 
script qui crée l'objet. 

Cet accès aux variables de la classe est aussi valable si l'une de ces variables est un 
tableau. Pour accéder à la valeur d'un des éléments du tableau, vous écrirez, par exemple : 

I $this->montab[l] 

si la variable Smontab a été déclarée dans la classe avec, par exemple, la fonction array( ) 
selon le modèle : 

I public Smontab = array( "val eurl" , "valeur?" ) ; 

L'exemple 9-5 permet de modifier la classe action qui définit deux constantes (repères O 
et 0) utilisées ensuite par la méthode infoO (repères Q et 0). Vous y retrouvez les 
mêmes variables $nom, $cours et $bourse, qui est un tableau (repère 0). 

La méthode info( ) utilise la variable globale $cl ient (repère 0), qui sera définie dans le 
script créant un objet de type action (voir exemple 9-6), ainsi que le tableau superglobal 
$_SERVER pour lire le nom du serveur (repère 0). 

La lecture des éléments du tableau $bourse permet l'affichage des horaires d'ouverture 
des bourses (repère 0). En cas de création d'un objet et donc de définition des valeurs 
de ses propriétés nom et cours, la fonction vous permet d'afficher les informations sur 
l'action créée (repère 0). 

Exemple 9-5. Utilisation des variables propres par une méthode 

<?php 

class action 
{ 

//Définition d'une constante 
const PARIS="Palais Brognard" ; <— 0 
const NEWYORK="Wall Street"; ^0 
//Variables propres de la classe 
public $nom ; 
public $cours; 

public $bourse=array("Paris " . "9h00" , "18h00" ) ; <— 0 
//fonctions propres de la classe 
function infoO 
{ 

global $cl ient; <— O 
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//utilisation de variables globales et d'un tableau superglobal 
echo "<h2> Bonjour $client, vous êtes sur le serveur: ", 
*»$_SERVER["HTTP_HOST"] , •'</h2>" ; <-© 

echo "<h3>Informations en date du " ,date( "d/m/Y H: i :s" ) , "</h3>" ; 

echo "<h3>Bourse de {$this->bourse[0]) Cotations de {$thi s->bourse[l] } 

{$this->bourse[2]) </h3>";<-0 
//Informations sur les horaires d'ouverture 
$now=getdate( ) ; 
$heure= SnowChours"] ; 
$jour= $now["wday"] ; 
echo "<hr />"; 

echo ''<h3>Heures des cotations</h3>" ; 

if(($heure>=9 && $heure <=17)&& ($jour!=0 && $jour!=6)) 

{ echo "La Bourse de Paris ( ", self:: PARIS," ) est ouverte 

^<br>"; } <-0 

el se 

{ echo "La Bourse de Paris ( ", self:: PARIS." ) est fermée <br>"; } 

if(($heure>=16 && $heure <=23)&& ($jour!=0 && $jour!=6) ) 

{ echo "La Bourse de New York ( self:: NEWYORK," ) est ouverte 

^<hr>"; ) 

el se 

{echo "La Bourse de New York ( ", self:: NEWYORK," ) est fermée <hr>"; } 
//Affichage du cours 

if(isset($this->nom) && isset($this->cours)) 
{ 

echo "<b>L'action $this->nom cotée à la bourse de {$this->bourse[0]} 
'•vaut $this->cours &euro:</b><br />";<— 0 

} 

} 

} 

?> 

L'exemple 9-6 utilise cette classe pour créer des objets après l'inclusion du fichier 
objets. php (repère O). La variable $client est initialisée et sera utilisée par la méthode 
info( ) (repère 0). Après la création d'un objet action (repère ©) puis la définition de 
ses propriétés (repères 0 et 0), l'appel de la méthode i nf o( ) de l'objet (repère 0) affi- 
che l'ensemble des informations sur l'action créée et l'ouverture de la Bourse. La 
figure 9-2 illustre le résultat obtenu. 

'•^ Exemple 9-6. Création d'un objet action 

<?php 

requireC 'objetB.php' ) ; <— O 
$client="Geelsen": <— 0 
Smortendi = new actionO; <— 0 
Smortendi ->nom ="Mortendi"; <— O 
$mortendi->cours="12.76"; <— 0 
$mortendi->info( ) : <— 0 
?> 
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Fichier Édition Affichage Histofique Marque-pages Outils ? 

' C ' L_i htlp;//localhost/chap9/objet6.php 



Bonjour Gcclscn, vous êtes sur le serveur: localhost 

Informations en date du 02/02/2009 10:29:34 
Bourse de Paris Cotations de 9h00 à 18h00 



Heures des culaliuus 

La Bourse de Paris ( Palais Brognard ) est ouverte 
La Bourse de New York ( Wall Street ) est fermée 



L'action Mortendi cotée à la bourse de Paris vaut 12.76 € 



Figure 9-2 

Création et utilisation d'un objet 



Les modificateurs d'accessibilité 

Vous avez défini jusqu'à présent des propriétés et des méthodes qui étaient accessibles 
librement à l'aide du mot-clé public. PHP 5 introduit des niveaux d'accessibilité diffé- 
rents pour vous permettre de limiter l'accès aux propriétés et aux méthodes et par là 
même de réduire le risque de modification des propriétés. 



Accessibilité des propriétés 

Il existe trois options d'accessibilité, qui s'utilisent en préfixant le nom de la variable de 
la classe. Ces options sont les suivantes : 

• publ ic. Permet l'accès universel à la propriété, aussi bien dans la classe que dans tout 
le script, y compris pour les classes dérivées, comme vous l'avez vu jusqu'à présent. 

• protected. La propriété n'est accessible que dans la classe qui l'a créée et dans ses 
classes dérivées (voir la section « Héritage » de ce chapitre). 

• pri vate . C'est l'option la plus stricte : l'accès à la propriété n'est possible que dans la 
classe et nulle part ailleurs. 

Le code ci-dessous teste les différents niveaux d'accessibilité aux propriétés. La classe 
accès contient trois propriétés, munies respectivement des modificateurs public 
(repère O), protected (repère ©) et pri vate (repère 0). La méthode 1 i reprop( ) conte- 
nue dans la classe a accès à toutes ces propriétés, et ce quel que soit le modificateur 
utilisé (repère Q). La création d'un objet (repère 0) et l'appel de cette méthode affi- 
chent l'ensemble des propriétés (repère ©). L'appel de la propriété publique à partir de 
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cet objet est possible et permet d'afficher sa valeur (repère Q). Par contre, l'appel des 
propriétés protégées et privées (repères Q et Q) provoquerait une erreur fatale. Par 
contre, une boucle foreach appliquée au tableau, contenant l'ensemble des propriétés de 
la classe accès, permet d'afficher l'ensemble de ces propriétés et leur valeur (repère ©)■ 

<?php 

class accès 
{ 

//Variables propres de la classe 

public $varpub ="Propriété publ ique" ; <— O 

protected $varpro="Propriété protégée" ; <—© 

private $varpriv="Propriété privée"; <—0 

function 1 i reprop( ) <— © 

{ 

echo "Lecture publique: $this->varpub" , "<br />"; 
echo "Lecture protégée: $this->varpro" , "<br />"; 
echo "Lecture privée: $this->varpriv","<hr />"; 

} 

} 

$objet=new accesO; <— © 

$objet->l i reprop( ) ; <— © 

echo $objet->varpub; <— © 

//echo $objet->varpriv; Erreur fatale <—© 

//echo $objet->varpro; Erreur fatale <—© 

echo "<hr />"; 

foreach(get_class_vars( 'accès' ) as $prop=>$val ) <— © 
{ 

echo "Propriété ",$prop ," = ",$val,"<br />"; 

} 

?> 

Le résultat obtenu permet de visualiser les possibilités d'accès aux propriétés : 



Lecture publique: Propriété publique 
Lecture protégée: Propriété protégée 
Lecture privée: Propriété privée 

Propriété publique 

Propriété varpub = Propriété publique 

Propriété varpro = Propriété protégée 

Propriété varpriv = Propriété privée 



Accessibilité des méthodes 

PHP 5 permet désormais de définir des niveaux d'accessibilité pour les méthodes des objets. 

Vous retrouvez les mêmes modificateurs que pour les propriétés : 

• publ i c . La méthode est utilisable par tous les objets et instances de la classe et de ses 
classes dérivées. 
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• protected. La méthode est utilisable dans sa classe et dans ses classes dérivées, mais 
par aucun objet. 

• pri vate . La méthode n'est utilisable que dans la classe qui la contient, donc ni dans les 
classes dérivées, ni par aucun objet. 

Tout appel d'une méthode en dehors de son champ de visibilité provoque une erreur fatale. 

L'exemple 9-7 illustre l'emploi de ces modificateurs dans une classe. Celle-ci contient 
un propriété déclarée pri vate (repère Q) ^t trois méthodes déclarées, respectivement 
pri vate (repère 0), protected (repère 0) et public (repère 0). Cette dernière appelle les 
deux autres méthodes (repères 0 et ©). La création d'un objet (repère 0) et l'appel des 
différentes méthodes montrent que seule la méthode publique est utilisable par un objet 
(repère 0). Le fait de décommenter les deux dernières lignes du script (repères 0 et ®) 
pour utiliser les méthodes protégées et privées provoquerait une erreur fatale. Vous verrez 
à la section consacrée à l'héritage des exemples d'utilisation de méthodes protégées dans 
une sous-classe. 

'•^ Exemple 9-7. Accessibilité des méthodes 

<?php 

class accesmeth 
{ 

//Variables propres de la classe 
private $code="Mon code privé"; <—0 
//Méthodes 
//Méthode privée 

private function lireprivO <— 0 
{ 

echo "Lire privée " ,$this->code, "<br />"; 

) 

//Méthode protégée 

protected function lirepro()<— 0 

{ 

echo "Lire protégée " ,$this->code,"<br />"; 

) 

//Méthode publique 

public function lirepub()<— 0 

{ 

echo "Lire publique : " ,$this->code, "<br />"; 
$this->lirepro(): <— 0 
$this->l i repri v( ) ; <— 0 

) 

} 

//Appels des méthodes 

$objet=new accesmethC ) ; <— 0 

$objet->lirepub(): ^0 

//$objet->l i repro( );// Erreur fatal e <— 0 

//$objet->l i repri v( ): //Erreur fatal e <— (0 

?> 
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Le résultat obtenu en décommentant l' avant-dernière ligne est le suivant : 



Lire publique : Mon code privé 
Lire protégée Mon code privé 
Lire privée Mon code privé 

Fatil errer: Cal! to protected method accesmeth: :lirepro() from context '' in c:\wimp5\ 
www\php5\C9objets\objet8.php on line 32 



Propriétés et méthodes statiques 

PHP 5 introduit la notion de propriété et de méthode statique, qui permet d'accéder à ces 
éléments sans qu'il soit besoin de créer une instance de la classe. Pour déclarer une 
propriété ou une méthode statique, vous devez faire suivre le mot-clé définissant l'acces- 
sibilité du mot-clé static. 

Comme les méthodes statiques sont utilisables sans la création d'objet, vous ne devez pas 
utiliser la pseudo-variable $this pour faire référence à une propriété de la classe dans le 
corps de la méthode. Vous devez utiliser à la place une des syntaxes suivantes : 

I self : :$propriété 

si la méthode est celle de la même classe, ou encore : 

I nomclasse: :$propriété 

si la méthode est celle d'une autre classe. 

Notez qu'il faut conserver le signe $ pour désigner la propriété, contrairement à ce que 
vous faisiez précédemment. 

De même, pour appeler une méthode statique de la classe à partir d'une autre méthode, 
vous utilisez les mêmes syntaxes, avec les mêmes conditions que ci-dessus : 

Iself : :$méthode() 
nomclasse: :$inéthode() 

Si vous créez un objet instance de la classe, la propriété déclarée static n'est pas acces- 
sible à l'objet en écrivant le code $objet->propriété. Par contre, les méthodes statiques 
sont accessibles par l'objet avec la syntaxe habituelle $objet->méthode( ). 

Si vous modifiez la valeur d'une propriété déclarée statique à partir d'un objet, cette 
modification n'est pas prise en compte par les méthodes qui utilisent cette propriété. Il y 
a donc un danger de confusion difficile à localiser puisque aucune erreur n'est signalée. 

L'exemple 9-8 présente ces différentes caractéristiques et leur emploi. Vous y créez une 
classe nommée info contenant une propriété statique $bourse initialisée (repère O)- Une 
méthode statique n'utilisant aucune propriété retourne simplement l'heure en cours 
(repère 0). Vous créez ensuite une méthode, également statique, qui utilise la propriété 
$bourse et la méthode précédente au moyen des notations self:: et i nf o : : (repère 0). 
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Pour lire la propriété $bourse à l'extérieur de la classe, écrivez le code suivant : 
I info: :$bourse (repère©). 

L'appel des méthodes hors de tout contexte objet se fait de la même façon (repères Q 
et ©). 

Pour montrer le danger de l'utilisation d'une propriété statique dans un contexte objet, un 
objet de type i nf o (repère Q) est créé, puis une nouvelle valeur est affectée à sa propriété 
bourse (repère©). L'affichage de cette propriété montre que cette affectation est bien 
réalisée (repère Q). En revanche, l'appel de la méthode de l'objet qui utilise cette 
propriété permet de constater que la propriété a toujours la valeur qui a été définie dans 
la classe (repères ®). Le mot stati c prend alors tout son sens. 

Pour pallier cet inconvénient, il faudrait ajouter à la classe une méthode spéciale qui 
modifierait la propriété bourse de la manière suivante : 

public function setbourse($val ) 
{ 

info: : $bourse=$val ; 

} 

Exemple 9-8. Propriété et méthode statiques 

<?php 

class info 
{ 

//Propriété statique 

public static $bourse="Bourse de Paris"; <—© 

//Méthodes statiques 

public static function getheure( ) <— © 

{ 

$heure=date( "h : m : s"); 
return $heure; 

) 

public static function afficheinfoC ) 
{ 

$texte=info: :$bourse. " , il est " .sel f : :getheure( ) ; <— © 
return $texte; 

) 

} 

echo info: : $bourse, "<br />":<—© 
echo info: :getheure( ) ."<br />";<—© 
echo info: :afficheinfo( ) , "<hr />";<—© 
//Création d'un objet info 
$objet=new infoO; <— © 
$objet->bourse="New York"; <— © 

echo "\$objet->bourse : " ,$objet->bourse,"<hr />";<—© 

echo "\$objet->getheure( ) : " ,$objet->getheure( ) ,"<br />";<—© 

echo "\$objet->afficheinfo() : " .$objet->afficheinfo( ) , "<br />";<—© 

?> 
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Le résultat obtenu est le suivant : 



Bourse de Paris 
04 : 10 : 56 

Bourse de Paris, il est 04 : 10 : 56 
$objet->bourse : New York 

$objet->afficheinfo( ) : Bourse de Paris, il est 04 : 10 : 56 



Constructeur et destructeur d'objet 

Dans ce qui précède, vous avez créé des objets en instanciant la classe action puis avez 
défini les propriétés des objets ainsi créés. Cette méthode est un peu lourde, car elle 
implique de définir les propriétés une par une. Il existe une façon plus élégante et plus 
rapide de créer des objets et de définir leurs propriétés en une seule opération. Elle 
consiste à créer un constructeur d'objet, qui n'est rien d'autre qu'une fonction spéciale de 
la classe, dont les paramètres sont les valeurs que vous voulez attribuer aux propriétés 
de l'objet. 

PHP 5 permet désormais de créer des constructeurs unifiés avec la méthode construct( ), 

dont la syntaxe est la suivante : 

I void construct(divers Sargumentl argumentN) 

Cette méthode, dite « méthode magique » comme toutes celles qui commencent par deux 

caractères de soulignement ( ), porte le même nom, quelle que soit la classe, ce qui 

permet des mises à jour sans avoir à modifier le nom du constructeur. Elle ne retourne 
aucune valeur et est utilisée généralement pour initialiser les propriétés de l'objet et 
éventuellement pour afficher un message de bonne fin. 

Elle est appelée automatiquement lors de la création d'un objet à l'aide du mot-clé new 
suivi du nom de la classe et des paramètres du constructeur, en utilisant la syntaxe 
suivante : 

I $mon_objet = new nom_cl asse(paraml ,param2 ) 

Vous avez créé un objet nommé $mon_objet et initialisé chacune de ses propriétés avec les 
valeurs des paramètres passés à la fonction. 



Constructeur et PHP 4 

Dans PHP 4, le constructeur était une fonction qui portait simplement le même nom que la classe. 



De même, vous avez la possibilité avec PHP 5 d'utiliser des destructeurs unifiés à l'aide 
de la fonction destruct( ), dont la syntaxe est la suivante : 

I void destruct( ) 



Elle s'utilise sans paramètre car elle n'est généralement pas appelée directement et ne 
retourne aucune valeur. Elle est appelée automatiquement soit après la destruction expli- 
cite de l'objet avec la fonction unset( ), soit après la fin du script et la disparition de toutes 
les références à l'objet. Le corps de cette méthode contient typiquement des instructions 
qui permettent de gérer proprement la destruction d'un objet, comme la fermeture expli- 
cite d'un fichier (voir le chapitre 1 1) ou d'une connexion à une base de données (voir le 
chapitre 15). 



Destructeur et PHP 4 

Dans PHP 4, la notion même de destructeur n'existait pas. Il fallait coder spécialement les conséquences 
de la destruction d'un objet. 



Lors de la création de sous-classes (voir la section « Héritage »), les constructeurs et 
destructeurs de la classe parente ne sont pas appelés implicitement, même si la classe 
enfant n'a pas son propre constructeur. Pour appeler explicitement le constructeur ou 
le destructeur de la classe parente dans la classe enfant, vous devez utiliser la syntaxe 
suivante : 

I parent: : construct( ) 
parent: : destruct( ) 

L'exemple 9-9 crée une nouvelle classe action munie de trois propriétés et d'un cons- 
tructeur, qui reçoit trois paramètres, le dernier ayant une valeur par défaut (repère O)- 
Vous pouvez donc créer un objet en ne précisant que les deux premiers. Le constructeur 
initialise les trois propriétés de l'objet (repères Q, Q et ©). Le destructeur affiche un 
message utilisant la propriété propnom et annonce la destruction de l'objet (repère 0). 

Vous créez ensuite trois objets action en utilisant la valeur par défaut du dernier para- 
mètre (repère ©) ou en passant explicitement une valeur (repères Q et ©). Vous créez 
également une référence à l'un de ces objets (repère 0). L'appel de la fonction var_ 
clump( ) affiche la structure de l'objet $al cotel (repère ®)- La destruction explicite de cet 
objet entraîne l'appel du destructeur et l'affichage d'un message (repère 0). Par contre, 
la destruction explicite de l'objet $bim (repère ®) ne provoque pas l'appel du destructeur 
car il existe encore une référence à cet objet. En consultant l'affichage réalisé par le 
script, vous constatez qu'après le message de fin de script (repère ©), le destructeur est 
appelé pour les objets $bim et $bouch. 

Exemple 9-9. La classe action munie d'un constructeur et d'un destructeur 

<?php 

class action 
{ 

private Spropnom; 
private Spropcours; 
protected SpropboLirse; 

function construct($nom,$cours,$bourse=''Paris") <— O 
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$thi s->propnom=$nom; <— © 
$thi s->propcours=$coLirs ; <— © 
$this->propbourse=$bourse; <— O 

} 

function destructO 

{ 

echo "L'action $this->propnom n'existe plusKbr />";<—© 

} 

} 

//Création d'objets 

$alcotel = new actionC "Al cotel" , 10.21) ; <—© 
Sbouch = new action("Bouch",9.11,"New York");<— © 
$bint = new action("BIM",34.50."New Yorl<");<— © 
$ref=&$bim: <— © 
var_duinp($alcotel ) ; <— (E) 
echo "<hr />"; 
unset($alcotel ); <— © 
unset($bim) ; <— © 

echo "<hr /><h4> FIN du script </h4><hr />";<-© 
?> 

Le script affiche le résultat suivant : 



object(action)#l (3) { ["propnom:private"]=> string(7) "Alcotel" 
["propcours:private"]=> float(10.21) ["propbourse:protected"]=> string(5) "Paris" } 

L'action Alcotel n'existe plus! 

FIN du script 

L'action Bouch n'existe plus! 
L'action BIM n'existe plus! 



Déréférencement 

Vous avez vu que l'appel d'une méthode d'objet se faisait selon la syntaxe suivante : 
I $varobj->methode( ) ; 

Dans le cas où la méthode appliquée à un objet retourne elle-même un objet et que celui- 
ci possède ses propres méthodes, il est possible avec PHP 5 de pratiquer le déréférence- 
ment. Cela permet d'enchaîner les appels de méthodes les uns à la suite des autres. 

Vous pouvez écrire le code suivant : 

I $varobj->methDdel( )->inethode2( ) ; 

à condition que methode2( ) soit une méthode de l'objet obtenu par l'appel de methodeK ). 

Dans l'exemple 9-10 vous créez une classe nommée varchar représentant une chaîne de 
caractères (repère ©). Cette classe possède trois méthodes. Le constructeur définit la 
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propriété chaîne avec la valeur du paramètre qui lui est passé (repère 0). La méthode 
add( ) réalise la concaténation de deux chaînes (repère 0) et retourne l'objet en cours (de 
type varchar), dont la propriété chaîne est modifiée (repère©). La méthode getchO 
retourne la valeur de la propriété chai ne, ce qui permet son affichage (repère 0). Après la 
création d'un objet $texte de type varchar et l'initialisation de sa propriété chaîne 
(repère ©), l'appel de la méthode getch( ) retourne cette propriété, qui est de type string 
(repère 0). Il est alors impossible d'appliquer une autre méthode à cette valeur. Par 
contre, si vous appelez d'abord la méthode adcl( ), il devient possible d'enchaîner avec la 
méthode getchO pour allonger la chaîne puis l'afficher car addO retourne un objet 
varchar (repère 0). Dans les mêmes conditions, vous pouvez envisager d'enchaîner les 
méthodes les unes aux autres et, par exemple, appliquer plusieurs fois la méthode add( ) 
puis la méthode getchO pour réaliser un affichage (repère 0). 

Exemple 9-10. Déréférencement de méthodes 

<?php 

cl ass varchar <— 0 
{ 

private $chaine; 

function constructCSa) <— 0 

$this->chaine= (string)$a; 

function add($addch) 

$this->chaine.=$addch; <— 0 
return Sthis; <— O 

function getch( ) 

return $this->chaine; <— 0 

} 

//Création d'objet 

$texte=new varchar( "Apache ");<— 0 

echo $texte->getch(),"<hr />";<— 0 

echo $texte->add( " PHP 5 " )->getch( ) . "<hr />";<— 0 

echo $texte->add(" MySQL ")->add(«SQLite " )->getch( ) . "<hr />";<-0 

?> 

L'exécution du script 9-1 1 affiche le résultat suivant : 



Apache 

Apache PHP 5 

Apache PHP 5 MySQL SQLite 
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Déréférencement et PHP 4 

Dans PHP 4, le déréférencement n'était pas possible. Il faiiait utiiiser une variable intermédiaire pour 
contenir le résultat de l'appel de la première méthode puis lui appliquer la deuxième méthode. 



Typage des paramètres 

Vous savez que PHP est un langage peu typé et qu'il n'est pas possible de fixer le type 
d'un paramètre dans une fonction personnalisée. Cependant PHP 5 introduit une nuance 
en permettant désormais d'imposer un type au paramètre d'une méthode, mais unique- 
ment pour les paramètres qui sont de type object ou array et pas encore pour les types de 
base de PHP, comme les types string ou integer. Pour imposer le type d'un paramètre, 
vous devez faire précéder le nom de la variable par le nom de la classe dont le paramètre 
doit être une instance. 

Vous écrivez, par exemple : 

function (action $var) 
{ 

//Corps de la fonction 
} 

Dans ce cas, le paramètre $var doit être un objet instancié à partir de la classe action et 
d'aucune autre. Si le type de la variable n'est pas conforme, une erreur fatale est générée. 

Héritage 

Vous avez considéré une classe comme un moule réutilisable à l'infini pour créer des 
objets. Que se passe-t-il si le moule ne convient plus, par exemple, parce que vous voulez 
créer des objets plus perfectionnés ? Faut-il le casser et en reconstruire entièrement un 
autre ? Vous pouvez aussi vouloir faire évoluer une classe en lui ajoutant de nouvelles 
fonctionnalités, que ce soit des propriétés ou des méthodes, sans pour autant devoir 
modifier le code de la classe d'origine. A l'instar des langages objet plus perfectionnés, 
PHP 5 donne la possibilité de dériver de nouvelles classes à partir d'une classe donnée, 
dont elles seront des améliorations. 

Enrichir un objet 

La définition d'une classe contient toutes les déclarations des propriétés d'un objet 
instancié. Une fois l'objet créé, vous pourriez vous attendre que le nombre de propriétés 
soit fixé définitivement. Or il n'en est rien. Vous pouvez ajouter des propriétés à un objet 
en cours de script sans avoir à modifier la classe. Il vous suffit pour cela d'utiliser la nota- 
tion d'affectation d'une propriété sous la forme suivante : 



I $objet->propriété = "valeur" 
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L'exemple 9-11 reprend l'essentiel de la définition de la classe action de l'exemple 9-10 
en définissant trois propriétés publ ic et un constructeur (repère O)- 

Une fois créé, l'objet $bim possède trois propriétés, que vous pouvez lire ou modifier 
(repère 0). La fonction var_dump( ) permet de visualiser ces propriétés (repère 0). 

L'affectation d'une nouvelle propriété (repère©) est réalisée avec la syntaxe $bim-> 
date="2001", comme s'il existait une propriété date. Un nouvel appel de var_dump() 
montre la nouvelle structure de l'objet $bim, qui contient bien maintenant quatre proprié- 
tés (repère 0). Cette propriété est accessible en lecture et en écriture en tout point du 
script, car elle est considérée comme ayant le niveau d'accès publ ic (repère ©). 

f*' Exemple 9-1 1 . Ajout dynamique d'une propriété 

<?php 

cl ass action <— O 
{ 

public SpropnoiTi; 
public $propcours; 
public Spropbourse; 

f unction construct($nom,$cours , Sbourse) 

{ 

$this->propnom=$nom; 
$this->propcours=$cours ; 
$this->propbourse=$bourse; 

} 

} 

$biir = new action("BIM",9.45,"New York");<— © 

var_dunip($biin) ; <— 0 

$bim->date="2001" ; 

echo "<hr />"; 

var_dunip($bim) ; <—Q 

echo "<hr />"; 

echo "Propriété date : " ,$bim->date: <— © 
?> 

L'affichage réalisé par ce script est le suivant : 



object(action)#l (3) { ["prDpnoin"]=> stringO) "BIM" ["propcours"]=> float(9.45) 

["prDpbourse"]=> string(8) "New York" } 

object(action)#l (4) { ["prDpnoin"]=> stringO) "BIM" ["propcours"]=> float(9.45) 

["propbourse"]=> string(8) "New York" ["date"]=> string(4) "2001" ) 

Propriété date : 2001 



Il montre bien que l'objet possède une propriété supplémentaire par rapport à celles défi- 
nies dans la classe dont il est une instance, mais la classe reste telle qu'elle a été définie, 
bien sûr. 
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Création d'une classe dérivée 

Le mécanisme de l'héritage est fondamental en POO. Il vous permet, en fonction des 
besoins, de faire évoluer une classe sans la modifier en créant une classe dérivée — on dit 
aussi une classe enfant, ou une sous-classe — à partir d'une classe de base, ou classe 
parente. La classe dérivée hérite des caractéristiques (propriétés et méthodes) de la classe 
parente, et vous lui ajoutez des fonctionnalités supplémentaires. Vous pouvez ainsi créer 
toute une hiérarchie de classes en spécialisant chaque classe selon vos besoins. Contrai- 
rement à d'autres langages, PHP 5 n'autorise que l'héritage simple, une classe ne pouvant 
hériter que d'une seule classe parente. 

Pour créer une classe enfant, faites suivre le nom de la nouvelle classe du mot-clé extends 
puis du nom de la classe parente, selon la forme suivante : 

class classenfant extends classparent 
{ 

//Propriétés et méthodes nouvelles 
} 

Dans le corps de la classe enfant, il est possible de redéfinir les propriétés et les méthodes 
de la classe parente, sauf si elles sont déclarées private ou final (voir plus loin). Il est 
encore possible d'accéder aux propriétés et aux méthodes redéfinies de la classe parente 
en les faisant précéder du mot-clé parent::. Si elles ne sont pas redéfinies, la classe 
enfant possède les mêmes propriétés et les mêmes méthodes que la classe parente. 



Cas particulier des constructeurs et destructeurs 

Même si la classe parente possède un constructeur et un destructeur unifié créés avec ies métiiodes 

constructO et destructO, ia classe enfant ne possède pas ces méthodes par défaut. Il faut 

recréer un constructeur et un destructeur propres à la classe enfant. Pour utiliser ceux de la classe 

parente, il faut les appeler explicitement avec la syntaxe parent: : construct( ) ou parent : : 

destruct( ). 



L'exemple 9-12 illustre le mécanisme de l'héritage en créant une classe val eur représen- 
tant une valeur mobilière plus large qu'une action (repère Q)- À elle seule, cette classe 
pourrait permettre la création d'objets. Elle contient en effet deux propriétés (repères Q 
et 0) et deux méthodes, un constructeur et une méthode d'affichage (repères Q et 0). A 
partir de cette classe de base, vous créez une classe dérivée action (repère©), qui 
possède une propriété supplémentaire (repère Q). Elle redéfinit un constructeur en utili- 
sant le constructeur parent (repère 0) et enrichit la fonction d'affichage (repère 0). Une 
deuxième classe dérivée de la classe valeur représente un titre d'emprunt (repère©)- 
Elle hérite également des propriétés de la classe parente et y ajoute deux propriétés 
(repères 0 et ®). Elle crée également un constructeur adapté recevant quatre paramètres 
(repère ©). Celui-ci utilise également le constructeur parent (repère ©). Enfin, elle 
redéfinit la fonction d'affichage pour l'adapter à la nature de l'emprunt (repère ©). La 
création des objets $actionl, $action2 et Semprunt montre que chacun d'eux a un construc- 
teur et une méthode i nf o( ) (repères ® et ©). 
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'■^ Exemple 9-12. Création de classes enfants 

<?php 

//Classe valeur 
class valeur <— O 
{ 

protected $noin; <— 0 
protected $prix; <— © 

function constrLict($noiii,$prix) <— O 

{ 

$this->noin=$nom; 
$this->prix=$prix: 

) 

protected function getinfo()<— 0 
{ 

$info="<h4>Le prix de $this->nom est de $this->prix </h4>"; 
return $info; 

} 

} 

//Classe action 

class action extends valeur <—© 
{ 

public Sbourse; <— O 

function construct($nom,$prix,$bDurse="Paris") 

{ 

parent: : construct($nom,$prix) ; <— 0 

$this->bourse=$bDurse; 

) 

public function getinfo()<— 0 
{ 

$info="<h3>Action $this->nom cotée à la bourse de $this->bourse </h3>"; 
$info.=parent: :getinfo( ) ; 
return Sinfo; 

) 

} 

//Classe emprunt 

class emprunt extends valeur <—® 
{ 

private $taux; <— ® 
private $fin; <— ® 

function construct($nom,$prix,$taux,$fin) <— © 

{ 

parent: : construct($nom,$prix) ; <— © 

$this->taux=$taux; 

$this->f in=mktime( 24, 0,0,12,31, $f in) : 

} 

public function getinfo()<— © 
{ 

$reste=round( ($this->fin - timeO ) /86400): 
$info="<h3>Emprunt $this->nom au taux de $this->taux % </h3>"; 
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$info.=parent: :getinfo( ) ; <— © 
$info.="<h4>Echéance : dans $reste jours</li4>" ; 
return $info; 

} 

} 

//Création d'objets 

Sactionl = new action( "Al cotel " ,9.76) ; <— © 
echo $actionl->getinfo( ) : 

$action2 = new action("BMI",23.75,"New York");<— ® 
echo $action2->getinfo( ) ; 

Semprunt = new emprunt("EdF",1000,5.5,2012); <— © 

echo $emprunt->getinfo( ) ; 

?> 

L'affichage obtenu est présenté à la figure 9-3. 



3 lill|i;//luudlifus(/[jlitjS/C9uUjt;U/uljjt;(12.plip -Miuiu^uri hilei iiul ExpUiiui 




Fichieï Edtion Afficf«ge Favoris Outils ? 




^Précédente • ' [»j -^i) ^Retherdier «j^Favotis (^Méita 0- | 




Adresse ^ httpi;/localhostA)hp5/C9ot)je«s/objetl2.php 


V'I 0 OK Liens " 


Action Alcotel cotée à la bourse de Paris 


A 


Le prix de Alcotel est de 9.76 




Acdon BMI cotée à la bourse de New York 




Le prix de BMI est de 23.75 




Emprunt EdF au taux de S.S % 




Le prix de EdF est de 1000 




Echéance ; dans 449 jours 




^ lefmmé 


*^ intranet local 



Figure 9-3 

Création de classes enfants 



Late Static Binding 

Le mécanisme du Late Static Binding (que l'on peut traduire par liaison statique tardive) 
a été introduit dans la version PHP 5.3 et permet de résoudre les problèmes qui surve- 
naient quand une méthode statique était redéfinie dans une classe dérivée et qu'une autre 
méthode statique héritée de la classe parent y faisait appel. En effet, dans ce cas, c'est la 
méthode statique de la classe parent qui était utilisée, l'appel se faisant jusqu'à présent 
avec la syntaxe : 



I sel f : :inethode( ) 
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Pour pallier cet inconvénient, la version PHP 5.3 introduit un nouvel usage du mot-clé 
stati c. En utilisant la syntaxe : 

[ static: :methode( ) 

c'est bien la méthode redéfinie de la classe enfant qui est appelée. 
Le code suivant illustre cette nouveauté: 
<?php 

cl ass pere <— O 
{ 

static public function info($nom) <— 0 
{ 

static: :affiche($noin) ; <— © 

) 

static public function affiche($noin) <— © 
{ 

echo "<h3>Je suis le père Snom </h3>"; 

} 

} 
/ 

cl ass fils extends pere 
{ 

static public function affiche($noin) <— @ 
{ 

echo "<h3>Je suis le fils $nom </h3>"; 

} 

} 

fils: :info( 'Matthieu' ); <— 0 
?> 

La classe pere (repère Q) définit deux méthodes statiques infoO etafficheO (repères© 
et 0Î), la méthode i nf o ( ) appelant la méthode af f i che ( ) (repère 0). La classe fils, déri- 
vée de la précédente, redéfinit la méthode statique afficheO (repère 0) et hérite de la 
méthode info( ). L'appel de la méthode statique info( ) de la classe fils (repère 0) affiche 
bien, comme nous le désirons : 



Je suis le fils Matthieu 



et non pas, comme c'était le cas avant la version 5.3 : 



Je suis le père Matthieu 



si l'on utilisait sel f : :affiche($nom) au lieu de static: :affiche($nom). 
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Les classes abstraites 

PHP 5 fournit un degré supplémentaire d'abstraction des classes en permettant la création 
de classes et de méthodes abstraites. Une classe abstraite ne permet pas l'instanciation 
d'objets mais sert uniquement de classe de base pour la création de classes dérivées. 
Elle définit en quelque sorte un cadre minimal auquel doivent se conformer les classes 
dérivées. 

Une classe abstraite peut contenir des méthodes déclarées public ou protected, qu'elles 
soient elles-mêmes abstraites ou non. Une méthode abstraite ne doit contenir que 
sa signature, sans aucune implémentation. Chaque classe dérivée est chargée de créer sa 
propre implémentation de la méthode. Une classe contenant au moins une méthode 
abstraite doit obligatoirement être déclarée abstraite, sinon elle permettrait de créer des 
objets qui auraient une méthode non fonctionnelle. 

Pour créer une classe abstraite, faites précéder le mot-clé class du mot-clé abstract, 
comme ceci : 

abstract class nomclasse 
{ 

//Définition de la classe 
} 

Pour créer une méthode abstraite, faites également précéder le modificateur d'accès du 
mot-clé abstract, selon le modèle suivant : 

I abstract public function nomfonction( ) ; 

Dans la classe qui dérive d'une classe abstraite, vous devez définir les modificateurs 
d'accessibilité des méthodes avec une visibilité égale ou plus large que celle de la méthode 
abstraite. Une classe abstraite définie, par exemple, protected, est implémentée dans les 
classes dérivées comme protected ou publ 1c. 

L'exemple 9-13 reprend la création des classes enfants action et emprunt de l'exemple 9- 
12. Il permet de réaliser la même opération mais à partir d'une classe abstraite nommée 
valeur (repère O). A la différence de l'exemple précédent, il n'est pas possible de créer 
des objets à partir de la classe val eur. Vous ne pouvez le faire qu'à partir de ses classes 
dérivées. Cette classe valeur contient deux propriétés et deux méthodes abstraites (repè- 
res Q et 0). Chacune des classes dérivées (repères Q et Q) doit donc créer sa propre 
implémentation complète de ces méthodes (repères 0, ©, @ et Q). Il n'est plus ques- 
tion ici d'utiliser une méthode parente, comme dans l'exemple 9-13. Le code s'en trouve 
alourdi, ce qui doit faire réfléchir avant d'utiliser des classes abstraites. 

Exemple 9-13. Dérivation de classe abstraite 

<?php 

//Classe abstraite valeur 
abstract class valeur <—0 
{ 

protected $nom; 
protected $pr1x: 
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abstract protected function constructO ; <— © 

abstract protected function getinfo( ) ; <— © 

} 

//Classe action 

class action extends valeur <—© 
{ 

private $bourse; 

function construct($nom,$prix,$bourse="Paris") <— 0 

{ 

$this->nom=$nom; 

$this->prix=$prix; 

$this->bourse=$bourse; 

) 

public function getinfo()<— © 
{ 

$info="Action $this->noin cotée à la bourse de $this->bourse <br />"; 
$info. = "Le prix de $this->norti est de $this->prix" ; 
return $info; 

} 

} 

//Classe emprunt 

class emprunt extends valeur <—© 
{ 

private $taux; 
private $fin; 

function construct($nom,$prix,$taux,$fin) <— 0 

{ 

$this->nom=$nom: 

$this->prix=$prix: 

$this->taux=$taux; 

$this->fin=mktime(24.0,0,12,31,$fin) : 

} 

public function getinfo()<— 0 
{ 

$reste=round(($this->fin-time())/86400) : 

$info="Emprunt $this->nom au taux de de $this->taux % <br />"; 
$info.="Echéance : fin $fin (dans $reste jours)"; 
return Sinfo; 

} 

} 

//Création d'objets 

Sactionl = new actionC "Al cotel " ,9 .76) ; 
echo "<h4>", $actionl->getinfo( ) , " </h4>"; 
$action2 = new action("BMI",23.75,"New York"); 
echo "<h4>". $action2->getinfo( ) ."</h4>"; 
$emprunt = new emprunt( "EdF" .1000,5.5 .2012) ; 
echo "<h4>", $emprunt->getinfo( ) . "</h4>" ; 
?> 

Le résultat obtenu est identique à celui de l'exemple 9-13, présenté à la figure 9-3. 
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Les interfaces 

La conception orientée objet s'accompagne d'une décomposition de l'application en 
modules élémentaires. L'introduction des interfaces dans PHP 5 permet cette décompo- 
sition en briques de base qu'une classe utilise comme modèle. 

La notion d'interface est encore plus restrictive que celle de classe abstraite. Une inter- 
face ne doit contenir aucune déclaration de propriétés. C'est la classe qui l'implémente 
qui doit se charger de ces déclarations. Une interface ne contient aucune implémentation 
de méthode, à la différence d'une classe abstraite, qui peut contenir des méthodes entiè- 
rement définies. Les méthodes qu'elle contient ne peuvent être déclarées qu'avec le 
modificateur publ ic ou aucun modificateur, ce qui est équivalent. L'interface ne fait que 
définir une structure à laquelle la classe qui l'implémente doit se conformer. PHP 5 
n'admet pas l'héritage multiple, mais une classe peut implémenter plusieurs interfaces. 

La structure d'une interface doit respecter la forme suivante : 

interface noin_interface 
{ 

public function fonctionl($var) ; 
public function fonction2($var) ; 

} 

Pour implémenter une interface dans une classe, il faut faire suivre le nom de la classe du 
mot-clé implements à la place de extends puis des noms des interfaces séparés par des 
virgules. 

Vous avez donc la structure suivante : 

class nom_classe implements interfacel ,interface2 
{ 

//Implémentation des méthodes des interfaces 
} 

Les interfaces définissant un cadre à respecter strictement, la classe qui les implémente 
doit obligatoirement définir toutes les méthodes des toutes les interfaces. 

L'exemple 9-14 crée une interface nommée abscisse (repère Q) Qui déclare une méthode 
setxO, dont le rôle est d'initialiser une abscisse (repère©). Il crée également une 
interface nommée ordonnée (repère©) déclarant une méthode setyO, dont le rôle est 
similaire pour l'ordonnée d'un point (repère ©). 

Ces interfaces sont implémentées par deux classes différentes. La classe pointaxe repré- 
sente un point sur un axe, n'ayant donc qu'une seule coordonnée. Elle implémente 
l'interface abscisse (repère©) et définit la méthode setxO (repère©). La classe 
poi ntpl an représente un point du plan, avec deux coordonnées. Elle implémente donc les 
deux interfaces absci sse et ordonnée (repère ©) et définit les méthodes setx( ) (repère ©) 
et sety( ) (repère ©), comme l'imposent les interfaces. 

L'implémentation des interfaces dans une classe impose certes la définition de leurs 
méthodes mais n'empêche pas d'enrichir la classe avec d'autres méthodes. La classe 
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pointplan possède une méthode supplémentaire moduleO, qui retourne la distance du 
point M(x,y) à l'origine du repère (repère ©)• Elle pourrait, par exemple, s'enrichir 
d'une méthode retournant l'angle (Ox,OM) et permettre ainsi la gestion des nombres 
complexes. 

'•^ Exemple 9-14. Création d'interface et implémentation 

<?php 

interface abscisse <—^J 
{ 

public function setx($x);<— © 

} 

// 

interface ordonnée <—0 
{ 

public function sety($y): <— © 

} 

//Classe 

class pointaxe implements abscisse <—@ 
{ 

public $x; 

public function setx($x) <— © 
{ 

$this->x=$x; 

) 

} 

// 

class pointplan implements abscisse, ordonnée <—© 
{ 

public $x; 
public $y; 

public function setx($x) <— @ 

$this->x=$x: 
public function sety($y) <— © 

$this->y=$y ; 
public function modul e( ) <— © 

return sqrt($this->x*$thi s->x+$this->y*$this->y ) ; 

} 

//Création d'objets 
$pointl = new pointaxeO; 
$pointl->setx(21) : 
var_dump($pointl) ; 
echo "<hr />"; 
// 
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$point2 = new pointplanO; 
$point2->setx(7) ; 
$point2->sety(-5) : 
var_dump($point2) ; 
echo "<hr />"; 

echo "Coordonnées du point M ( $point2->x , $point2->y ) <br />"; 

echo "Distance OM = ", $point2->modul e( ) ; 

?> 

Le résultat affiché est le suivant : 



object(pointaxe)#l (1) { ["x"]=> int(21) } 

object(pointplan)#2 (2) { ["x"]=> int(7) ["y"]=> int(-5) } 

Coordonnées du point M ( 7 , -5 ) 
Distance OM = 8.60232526704 



Méthode et classe finales 

La création de sous-classes et la redéfinition des méthodes sont les éléments essentiels de 
la POO. Il peut cependant être nécessaire d'empêcher toute modification d'une méthode 
ou d'une classe, en particulier dans un projet où l'on travaille en équipe. 

Pour interdire la redéfinition d'une méthode d'une classe parente dans ses classes déri- 
vées, faits précéder le mot-clé function du mot-clé final. 

Si vous définissez la classe suivante : 

class triangle 
{ 

private $x ; 
private $y ; 
private $z ; 

function construct($x,$y ,$z) 

{ 

$this->x=$x ; 
$this->y=$y ; 
$this->z=$z : 

) 

final function trianglerectO 

{ 

if(($this->x*$this->x + $this->y*$this->y) ==($this->z*$this->z)) 
^return "Le triangle est rectangle": 
else echo "Triangle non rectangle"; 

} 

} 

dans laquelle la fonction trianglerectO est déclarée final, il devient impossible de créer 
une classe dérivée qui contienne une méthode portant le même nom. 
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Le code suivant : 

class triangleiso extends triangle 
{ 

function tri angl erect( ) 
{ 

//Instructions 
} 

} 

provoque l'apparition d'une erreur fatale et du message : 



Fatal error: Cannot override final method triangle: :trianglerect( ) 



De même, pour interdire l'héritage d'une classe parente dans une classe enfant, faites 
précéder le mot-clé cl ass du mot-clé final. 

Si vous définissez la classe suivante : 

final class triangle 
{ 

//Instructions 

} 

et si vous tentez de la dériver en créant la classe enfant suivante : 

class triangleiso extends triangle 
{ 

//Instructions 

} 

vous créez également une erreur fatale accompagnée du message : 



Fatal error: Class triangleiso may not inherit from final class (triangle) 



Clonage d'objet 

La notion de clonage d'objet est une des nouveautés introduites dans PHP 5. Elle permet 
d'effectuer une copie exacte d'un objet mais en lui affectant une zone de mémoire diffé- 
rente de celle de l'objet original. Contrairement à la création d'une simple copie à l'aide 
de l'opérateur = ou d'une référence sur un objet avec l'opérateur &, les modifications 
opérées sur l'objet cloné ne sont pas répercutées sur l'original. 

Pour cloner un objet, utilisez le mot-clé cl one selon la syntaxe suivante : 

I $objetclone = clone $objet ; 

L'objet cloné a exactement les mêmes propriétés et les mêmes méthodes que l'original. 
Après le clonage, les modifications opérées sur la variable $ objet n'ont aucun effet sur le 
clone, et réciproquement. 
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Si, lors du clonage, vous voulez modifier des propriétés du clone par la même occasion, 

vous utilisez la méthode prédéfinie cloneO propre à tous les objets PHP 5. Elle peut 

contenir toutes sortes d'instructions agissant sur les propriétés du clone. Sa présence 
dans la classe est facultative. Si elle existe, elle est appelée automatiquement lors de la 
création d'un clone avec le mot-clé cl one. Comme le constructeur, elle ne peut être appe- 
lée directement. 

L'exemple 9-15 fait apparaître les différences entre une simple copie, une référence et un 
clonage. Vous y définissez une classe action simplifiée (repère O) ayant une seule 
propriété et un constructeur (repère ©), un destructeur, qui affiche un message après 

la destruction de l'objet (repère©), et une méthode cloneO chargée de modifier la 

propriété nom (repère ©). Vous l'utilisez ici uniquement pour distinguer le clone de 
l'original. 

Pour vérifier les différences de comportement des copies et des clones, vous créez un 
objet $alcotel (repère 0), son clone dans la variable $clone (repère 0) et une copie et 
une référence de $alcotel, respectivement dans $bim (repère Q) et $ref (repère ©). La 
modification de la propriété nom de l'objet $bim (repère Q) est répercutée dans les objets 
$al cotel et $ref, comme le prouve l'affichage de leur propriété nom (repères ® et ®). 

L'affichage simple des variables $al cotel , $bim et $ref fournit le même résultat (Object id 
#1), qui montre que ces trois objets font bien référence au même espace mémoire 
(repère ®). En revanche, le même affichage pour l'objet $cl one fournit un résultat diffé- 
rent : Object id #2 (repère ©). 

La destruction du clone (repère ©) entraîne immédiatement l'appel du destructeur, 
alors que la destruction successive des autres objets (repères ©, © et ®) montre que le 
destructeur n'est appelé qu'après la destruction de la dernière référence à l'objet 
$alcotel. 

'•^ Exemple 9-15. Copie et clonage 

<?php 

class action <— O 
{ 

public $nom: 

function construct($nom) <— © 

{ 

$this->noin=$nom;//2 

} 

function destructC ) <— © 

{ 

echo "L'action $this->nom n'existe plusKbr />";//5 

} 

function cloneO <— O 

{ 

$this->noin="Clone de " . $thi s->nom: 

} 

} 



272 



PHP 5 



//Création d'objets 

$alcotel = new action( "Al cotel ", 10.21 ); <—© 

$clone= clone Salcotel; <— 0 

$bim=$al cotel ; <— O 

$ref=&$bim: ^0 

//Modification d'une propriété 

$bim->nom="BIM": 

echo $ref->nom ,"<hr />";<— ® 

echo $al cotel ->nom ,''<hr />";<— 0 

echo "alcotel = $alcotel : bim = $biin : ref = $ref : <hr />";<— 0 

echo "clone = $clone <hr />";<— 0 

//Suppression des objets 

unset($clone) ; <— 0 

unset($alcotel ) ; <— 0 

unset($biin) ; <— 0 

unset($ref ); ^0 

?> 

Le résultat affiché par ce script est le suivant : 



BIM 
BIM 

alcotel = Object 1d #1 : bim = Object id #1 : ref = Object id #1 : 

clone = Object id #2 

L'action Clone de Alcotel n'existe plus! 
L'action BIM n'existe plus! 



Le clonage d'objet peut donc être utile pour préserver l'état d'un objet hors de toute 
modification intempestive. 

Les namespaces 

Comme nous l'avons déjà préconisé à propos des fonctions, quand un projet pend de 
l'importance, et encore davantage quand il est réalisé en équipe, il y a tout intérêt à 
modulariser le code, chaque développeur travaillant sur un module donné. Introduits 
dans PHP 5.3 les namespaces (espaces de noms), qui sont les équivalents, par exemple, 
des packages en Java, facilitent cette modularisation. Ils nous permettent d'éviter égale- 
ment les conflits de noms de classe, propriétés, méthodes et fonctions. En effet, un de 
ces éléments peut avoir le même nom qu'un autre sans créer de conflit au moment 
de son appel, du moment que ces deux éléments sont définis dans des namespaces 
différents. 
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Syntaxe PHP 5.3 et PHP 6 

Au moment où ces lignes sont écrites, la version définitive de PHP 5.3 n'est toujours pas sortie et les 
nouveautés qui sont annoncées ne sont pas nécessairement figées. En particulier le séparateur utilisé 
dans le nom des namespaces pourrait soit être les caractères : : , comme dans les exemples qui suivent 
basés et testés sur la version PHP 6, soit le caractère anti-slash \, ce que confirment les tests effectués 
avec la version alplia 3 de PHP 5.3. Si ce clioix se confirme, il vous suffirait de remplacer les caractères : : 
dans les exemples suivants par le caractère \. 



Création et utilisation 

En pratique les namespaces sont des fichiers PHP ne définissant chacun qu'un seul 
espace de noms et qui peuvent contenir des définitions de classes, de constantes ou de 
fonctions. La première ligne du fichier doit contenir le mot-clé namespace suivi du nom 
choisi et se terminer par le traditionnel caractère ; comme n'importe qu'elle instruction. 
Tout ce qui suit cette ligne appartient au namespace nommé et à lui seul. Une mise en 
œuvre simple de namespace est présentée dans l'exemple 9-16. 

f*" Exemple 9-16. Exemple de namespace 

<?php 

namespace MonEspace: iTest; <— O 

const MYNAME = "Espace : MonEspace: :Test" ; <— 0 

function getO <— © 
{ 

echo "Je suis la fonction getO de l'espace ". NAMESPACE ."<hr />"; 

} 

class Personne <— O 
{ 

public $noin="JRE" ; <— 0 

public function construct($val ) <— © 

{ 

$thi s->noin=$val ; 

} 

public function get()<— © 

{ 

return $this->nom; 

} 

} 

?> 

Nous y créons un espace de noms nommé MonEspace: :Test composé d'un nom principal, 
MonEspace, et d'un nom secondaire. Test (repère Q)- Vous pouvez donc ensuite créer un 
autre espace de noms, dans un autre fichier .php (car il est impossible actuellement 
d'utiliser deux fois le mot-clé namespace dans le même fichier, ce qui est compréhensible 
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dans une optique de modularisation organisée) en le nommant par exemple MonEspace: : Base 
pour créer des fonctions ou des classes de gestion des bases de données. Ce type de nota- 
tion peut donc vous permettre de créer un nombre important de modules ayant chacun 
une application particulière. Cet espace contient successivement la définition d'une cons- 
tante, de la même manière que dans une classe avec le mot-clé const (repère 0), puis la 
déclaration d'une fonction (repère 0) et enfin celle d'une classe (repère contenant 
une propriété (repère 0), un constructeur (repère ©) et une méthode (repère 0). 

Tel quel notre espace de noms, à l'image d'une classe, ne sert à rien. Écrire, par exemple, 
dans un script, après avoir inclus le fichier du namespace, la ligne suivante : 

I echo MYNAME; 

pour lire la constante, ou encore appeler la fonction get( ) produit des erreurs. 

L'exemple 9-17 illustre l'utilisation du namespace de l'exemple 9-16. Vous commencez 
donc par inclure le fichier objetl6.php (repère 0) puis vous pouvez ensuite utiliser la 
constante MYNAME qui y a été définie en la préfixant avec le nom du namespace 
MonEspace: :Test: :MYNAME (repère 0). De même vous pouvez appeler la fonction getO 
en la préfixant également (repère 0). Il est possible de limiter le préfixe à la dernière 
partie du nom du namespace (ici Test) à condition d'utiliser auparavant le mot-clé use 
suivi du nom complet de l'espace de noms (repère 0). La constante et la fonction get( ) 
sont alors accessibles avec les formes courtes Test::MYNAME (repère 0) et Test::get() 
(repère 0). Pour créer un objet Personne, vous avez le choix entre la forme longue 
MonEspace: :Test: :Personne( ) du constructeur (repère 0) ou la forme courte PersonneO 
(repère 0) habituelle, à condition d'utiliser avant le mot-clé use suivi du nom complet du 
namespace et du nom de la classe (repère 0). Si l'espace de noms contient plusieurs 
classes, vous pouvez procéder de la même façon pour chacune d'elles. Il est alors beau- 
coup plus pratique de créer des objets avec une syntaxe simplifiée. Les méthodes de ces 
objets sont appelées comme d'habitude à partir des variables objets (repère ©). 

Exemple 9-17. Utilisation d'un namespace 

<?php 

require 'objetl6.php' ; <— 0 

/ /Constante 

echo"Une constante : ", MonEspace: :Test: :MYNAME ,"<hr />";<— 0 
echo "Appel de la fonction getO de l'espace MonEspace: :Test : 
echo MonEspace: :Test: :get( ) ; <— 0 

use MonEspace: :Test; <— 0 

echo"Une constante : ", Test: :MYNAME, "<hr />";<— 0 

echo "Appel de la fonction getO de l'espace MonEspace: :Test : "; 

echo Test::get(): <— 0 



//Objet 1 

$moi = new MonEspace: :Test: : Personnel "Moi "); <—0 
//Objet 2 
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use MonEspace: :Test: :Personne ; <— © 

$toi = new PersonneC "El 1 e" ) ; <— © 

//********Méthode et fonction du namespace 

echo "Appel de la méthode getO des objets Personne : <br />"; 

echo $toi->get(), " et " ,$nioi->get( ) ; ^© 

?> 

Nous allons maintenant envisager la création et l'utilisation de différents espaces de 
noms pour modulariser le gestion dans le cadre de nos exemples boursiers. Le premier 
namespace créé dans l'exemple 9-18 permet la gestion des actions ; il contient la défini- 
tion d'une classe Val eur qui possède deux propriétés (repères Q ^t ©), un constructeur 
(repère ©) et deux méthodes (repères © et ©). 

'■^ Exemple 9-18. Le namespace des actions 

<?php 

namespace Bourse: lAction; 

class Valeur 

{ 

public $nom: <— © 
public $cours; <— © 

public function CDnstruct($nom,$valeur) <— © 

{ 

$thi s->nom=$nom; 
$thi s->cours=$val eur ; 

) 

public function info()<— © 
{ 

echo date( 'd / m / Y : ' ) ; 

echo "L'action $this->nom vaut $this->cours €<br />"; 

) 

public function changeCours($val ) <— © 

{ 

$thi s->cours=$val ; 

} 

} 



?> 

Le second, créé dans l'exemple 9-19, permet la gestion des obligations (emprunts) ; il 
contient les définitions d'une fonction dateO de même nom qu'une fonction native de 
PHP (repère ©), d'une classe Valeur qui possède trois propriétés (repères ©, © et ©), 
un constructeur (repère ©) et deux méthodes (repères © et ©). Les propriétés et 
méthodes ont volontairement les mêmes noms, ce qui pourrait se produire si les deux 
namespaces étaient créés par des développeurs différents dans le cadre d'un travail en 
équipe. Nous allons voir que l'avantage des namespaces est de pouvoir en employer 
plusieurs sans qu'il y ait de conflits de noms. 
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Namespace global 

Si un namespace contient une fonction de même nom qu'une autre du script en cours ou qu'une fonction 
native PHP, cette dernière doit être appelée dans la définition du namespace en précisant qu'elle fait partie 
du namespace global en la faisant précéder par la notation double deux points ( : : ). Dans l'exemple 9-1 9, 
le namespace contient une fonction date( ) qui lui est propre. Pour utiliser la fonction native PHP date( ), 
nous devons écrire : :date( ) afin de préciser qu'il s'agit de celle du namespace global (repère Q de 
l'exemple 9-19). 



Exemple 9-19. Le namespace des obligations 

<?php 

namespace Bourse: :Obligation; 

function date()<— O 

{ 

echo " Fonction date" ; 
} 

class Valeur 
{ 

public $nom: <— 0 
public $cours: <— © 
public $taux; <— O 

public function construct($nom,$valeur,$taux) <— 0 

{ 

$this->nom=$nom; 
$this->cours=$ valeur; 
$this->taux=$taux; 

} 

public function info()<— © 
{ 

echo : :date( 'd / m / Y : ' ) ; <— Q 

echo "L'obligation $this->noin à $this->taux % vaut $this->cours € 
^<br />"; 

) 

public function changeCours($val ) <— © 
{ 

$this->cours=$val ; 

) 

} 

?> 

L'exemple 9-20 utilise les classes de ces deux namespaces Bourse-Action et Bourse:: 
Obi igation. Après l'inclusion des deux fichiers objetlS.php et objetl9.php qui les définis- 
sent (repères O ^t 0), nous déclarons l'utilisation de l'espace Bourse: :Action avec le 
mot-clé use (repère ©). Ceci permet la création d'un objet représentant une action avec 
le mot-clé new (repère 0) en précisant le nom du namespace nécessaire pour distinguer 
l'objet créé, car il existe une autre classe valeur dans le second namespace inclus. Il n'y a 
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ensuite aucun problème à utiliser les méthodes infoO et changeCours( ) de l'objet (repè- 
res 0, Q et O) qui, au vu des résultats affichés, sont bien celles de la classe Valeur du 
namespace Action. Avec la même syntaxe, nous utilisons le namespace Bourse: :Obl igation 
(repère©) et nous créons un objet Valeur représentant cette fois ci une obligation 
(repère 0), puis nous appelons ses méthodes (repères ©, Q et ®). 

f*' Exemple 9-20 Utilisation de plusieurs namespaces 

<?php 

require 'objetlS.php' ; <— O 
require 'objetl9.php' ; <— 0 

//Objet Action 

use Bourse: :Action ; <— © 

$action = new Action: :Valeur("Dex1a", 4.56); <—© 

$action->info( ) ; <— © 

$action->changeCours(4.72) ; <— © 

$action->info( ) : <— © 

//Objet Obligation 

use Bourse: :Obl igation : <—© 

$oblig = new Obligation: :Valeur("EdF", 55, 3.8); <—© 

$oblig->info(): <-® 

$obl ig->changeCours(56) ; <— © 

$oblig->info(): <-© 

?> 

Les résultats affichés sont les suivants : 



02 / 02 / 2009 : L'action Dexia vaut 4.56 n 

02 / 02 / 2009 : L'action Dexia vaut 4.72 n 

02 / 02 / 2009 : L'obligation EdF à 3.8 % vaut 55 n 

02 / 02 / 2009 : L'obligation EdF à 3.8 % vaut 56 n 



Ils confirment que l'appel des méthodes de même nom sont bien appliquées au type 
d'objet adéquat. 

Utilisation des alias 

En combinaison avec l'utilisation du mot-clé use, il est possible de créer des alias des 
noms des namespaces avant de créer les objets représentant une action ou une obligation. 
Nous obtenons de cette façon une variante de l'exemple 9-20 dans l'exemple suivant : 

Exemple 9-21 Utilisation d'alias 

<?php 

require 'objetlB.php' ; 
require 'objetl9.php' ; 
//Objet Action 

use Bourse: :Action: :ValeLir as aValeur; <— © 
$action = new aValeur("Dexia",4.56); <— © 



278 



PHP 5 



$action->info( ) ; 
$action->changeCours(4.72) ; 
$action->info( ) ; 
//Objet Obligation 

use Bourse: :Obl igation: : Val eur as oValeur;<— @ 

$oblig = new oValeur("EdF",55.3.8); <— O 

$obl ig->info( ) ; 

$obl ig->changeCours(56) ; 

$obl ig->info( ) ; 

?> 

La classe Valeur du namespace Bourse: :Action y est aliasée avec le nom aValeur 
(repère O) celle du namespace Bourse: :Obl igation avec le nom oValeur (repère©). 
C'est alors en utilisant ces alias de nom de classe que nous pouvons créer les objets dési- 
rés (repère Q et O)- 

Méthodes magiques 

Toutes les méthodes dont les noms commencent par deux caractères de soulignement 

sont des méthodes dites « magiques », dont la création est réservé à PHP et qui ont des 

rôles particuliers. Nous en avons déjà rencontré deux: constructO et destructO, 

respectivement constructeur et destructeur, appelées automatiquement lors de la création 
ou la destruction d'un objet. PHP en comporte d'autres qui sont appelées automatique- 
ment dans des circonstances données, à savoir : 

• set( ) est exécutée quand le script tente de modifier une propriété déclarée private 

ou protected. 

• getO est exécutée lorsque le script tente de lire une propriété déclarée private ou 

protected. 

• isset( ) est exécutée quand le script tente de vérifier, avec les fonctions isset( ) ou 

empty( ), si une propriété déclarée private ou protected existe ou est vide. 

• unsetO est exécutée quand le script tente de supprimer une propriété déclarée 

private ou protected avec la fonction unset( ). 

L'exemple 9-22 fournit des applications de ces méthodes. La classe macl asse possède une 
propriété code déclarée private, donc normalement inaccessible à partir d'un objet 
(repère Q)- Le constructeur permet d'affecter une valeur à cette propriété (repère 0). 

Les méthodes magiques set( ), get( ), isset( ) et unset( ) (repères Q, 0 et 0) 

créent chacune une action qui est déclenchée respectivement quand le script affecte une 
valeur à la propriété code, tente de la lire, vérifie son existence ou veut la supprimer. Sans 
la définition de ces méthodes, toutes ces actions déclencheraient une erreur. Pour le véri- 
fier nous créons un objet de type macl asse (repère 0), puis nous écrivons le code qui va 
déclencher chacune des méthodes magiques (repères 0, 0, ®, 0, 0, 0 et 0). Notez 
que les méthodes définies ici autorisent ces opérations, mais que leur code pourrait affi- 
cher des messages interdisant toute modification de la propriété code qui est privée. 
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<^ Exemple 9-22 Mise en œuvre des méthodes magiques 

<?php 

class maclasse 
{ 

pri vate $code ; <— O 

public function construct( $val ) <— 0 

$this->code = $val ; 

public function set($prop, $val) <— © 

echo "Affectation de la valeur $val à la propriété $prop <br /> "; 
$this->$prop = $val ; 

public function get($prop) <— O 

return $this->$prop; 

public function i sset ( $prop ) <— 0 

if (isset($this->$prop) ) echo "La propriété $prop est définie<br />"; 

else echo "La propriété $prop n'est pas définie <br />"; 

public function unset($prop) <— 0 

echo "Effacement de la prop $prop <br />"; 
unset($this->$prop); 

} 

//Création d'un objet 

$obj = new macl asse( ' AZERTY ' ) ; <— 0 

echo isset($obj->code) ; <— 0 

echo "code = ", $Dbj->code," <br />";<— 0 

$obj->code="QWERTY"; <-® 

echo "code = ", $obj->code," <br />";<— 0 

echo isset($obj->code) : <— 0 

unset($obj->code) : <— 0 

echo "code = ", $obj->code," <br />";<— 0 

?> 

Le script affiche les résultats suivants : 



La propriété code est définie 
code = AZERTY 
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Affectation de la valeur QWERTY à la propriété code 
code = QWERTY 

La propriété code est définie 
Effacement de la prop code 
code = 



Mémo des fonctions 

boolean class_exists (string $nomclasse) 

Détermine si la classe passée en paramètre existe ou non. 

string get_class(object $varobjet) 

Retourne le nom de la classe dont l'objet est une instance. 

array get_cl ass_inetliods( string nom_classe) 
array get_cl ass_niethods(object $varobjet) 

Retournent un tableau contenant tous les noms des méthodes de la classe ou de l'objet, 
array get_cl ass_vars(string noin_classe) 

Retourne un tableau associatif dont les clés sont celles des propriétés de la classe et contenant toutes valeurs par défaut 
de ces propriétés. 

array get_decl ared_cl asses ( ) 

Retourne un tableau de tous les noms des classes du script et des classes prédéfinies par PHP. 

array get_declared_interfaces( ) 

Retourne un tableau de tous les noms des interfaces du script. 

array get_object_vars (object $varobjet) 

Retourne un tableau de toutes les propriétés de l'objet. 

string get_parent_cl ass(string nom_classe) 
string get_parent_class(object $varobjet) 

Retourne le nom de la classe parente d'une classe ou d'un objet. 

bool iiiethod_exists (object $object, string $nonimetfiode ) 

Détermine si la métfiode précisée en paramètre existe ou non. 

bool is_subclass_of (divers $object, string $nomclasse ) 

Détermine si l'objet précisé a la classe $nomcl asse comme parent. 

Exercices 

Exercice 1 

Écrivez une classe représentant une ville. Elle doit avoir les propriétés nom et département et 
une méthode affichant « la ville X est dans le département Y ». Créez des objets vi 1 1 e, 
affectez leurs propriétés, et utilisez la méthode d'affichage. 
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Exercice 2 

Modifiez la classe précédente en la dotant d'un constructeur. Réalisez les mêmes opéra- 
tions de création d'objets et d'affichage. 

Exercice 3 

Créez une classe représentant une personne. Elle doit avoir les propriétés nom, prénom et 
adresse, ainsi qu'un constructeur et un destructeur. Une méthode getPersonne( ) doit 
retourner les coordonnées complètes de la personne. Une méthode setAdresseC ) 
doit permettre de modifier l'adresse de la personne. Créez des objets personne, et utilisez 
l'ensemble des méthodes. 



Exercice 4 

Créez une classe nommée form représentant un formulaire XHTML. Le constructeur doit 
créer le code d'en-tête du formulaire en utilisant les éléments <form> et <fieldset>. Une 
méthode setText( ) doit permettre d'ajouter une zone de texte. Une méthode setSubmit( ) 
doit permettre d'ajouter un bouton d'envoi. Les paramètres de ces méthodes doivent 
correspondre aux attributs des éléments XHTML correspondants. La méthode getFormC ) 
doit retourner tout le code XHTML de création du formulaire. Créez des objets form, et 
ajoutez-y deux zones de texte et un bouton d'envoi. Testez l'affichage obtenu. 

Exercice 5 

Créez une sous-classe nommée form2 en dérivant la classe form de l'exercice 4. Cette 
nouvelle classe doit permettre de créer des formulaires ayant en plus des boutons radio et 
des cases à cocher. Elle doit donc avoir les méthodes supplémentaires qui correspondent 
à ces créations. Créez des objets, et testez le résultat. 

Exercice 6 

Créez un objet à partir de la classe f orm2 de l'exercice 5, puis créez -en un clone. Modifiez 
certaines caractéristiques de cet objet, et affichez les deux formulaires obtenus. 

Exercice 7 

Créez une classe abstraite représentant une personne. Elle déclare les propriétés nom et 
prénom et un constructeur. Créez une classe cl ient dérivée de la classe personne en y ajou- 
tant la propriété adresse et une méthode setCoord( ) qui affiche les coordonnées complètes 
de la personne. Créez une classe él ecteur dérivée de la même classe abstraite, et ajoutez- 
y deux propriétés bureau_de_vote et vote, ainsi qu'une méthode avoter( ), qui enregistre si 
une personne a voté dans la propriété vote. 

Exercice 8 

Créez deux namespaces, nommés Firme: : Cl ient et Firme: : Commercial, possédant chacun 
des classes Personne. Chacune d'elles doit avoir des propriétés pour enregistrer les coor- 
données de la personne et son code, un constructeur et des méthodes set( ) et get( ) pour 
pouvoir modifier et afficher les propriétés. Créez ensuite des objets représentant deux 
clients et un commercial. 
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Exercice 9 

Intégrez les méthodes magiques connues à au moins une des classes de l'exercice 8 après 
avoir déclaré la propriété code comme protected. 



10 

Les images dynamiques 



PHP permet non seulement de créer des pages contenant du texte affiché dynamiquement 
mais également des images dynamiques en fonction des besoins. Vous allez voir comment 
créer des images dynamiques aux formats GIF, JPEG, PNG et même WBMP à destination 
des terminaux mobiles. 

PHP est livré avec l'extension GD (Graphie Devicé). La version actuelle, livrée avec 
PHP 5, vous permet de créer des images aux formats GIF, JPEG, PNG et WBMP. 

Pour vérifier si l'extension est installée sur votre serveur, utilisez la fonction phpinfo( ), et 
reportez-vous à la rubrique GD, qui contient le numéro de version et différentes caracté- 
ristiques, en particulier la possibilité d'utiliser des polices TrueType pour écrire du texte 
dans une image. Vous pouvez également utiliser la fonction gd_info(), qui retourne un 
tableau contenant les caractéristiques de l'extension. 

Principes généraux 

Sur le serveur local installé par Wampserver, l'extension GD est installée par défaut. 

Sur un serveur sur lequel elle ne serait pas disponible, vous devez décommenter la ligne 
suivante en supprimant le point- virgule placé au début de la ligne : 

I extension=php_gd2.dl 1 

Cette ligne se trouve dans le fichier php. i ni, situé dans le dossier C:\wamp\bin\apache\ 
apache2.2.8\bin dans lequel a été effectuée l'installation. L'affichage réalisé par le script 
contenant la fonction phpinfoO vous confirme que la bibliothèque GD est désormais 
utilisable. 
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Les scripts de création d'image doivent suivre les étapes suivantes : 

1. Envoi d'un en-tête précisant le type d'image qui sera envoyé du serveur vers le navi- 
gateur. Vous retrouvez ici la fonction header( ) sous la forme suivante pour une image 
de type PNG : 

I header("Content-type:image/png") ; 

Selon le format choisi, vous pouvez remplacer le type MIME de l'image par image/ 
jpeg, image/gif ou image/vnd.wap.wbmp. 

2. Création du cadre de l'image dans lequel vont être tracés les éléments de l'image en 
appelant la fonction imagecreate( ), qui définit les dimensions de l'image en pixels et 
réserve l'espace mémoire nécessaire sur le serveur. 

3. Création des couleurs qui vont être utilisées pour effectuer les tracés en utilisant 
les codes décimaux des couleurs RGB (Red, Green, Blue) à l'aide de la fonction 
imagecol oral 1 ocate( ). 

4. Tracé de formes géométriques dans le cadre. Les formes disponibles sont variées. 

5. Écriture du texte dans l'image à l'aide des polices incorporées ou de polices TrueType 
ou FreeType. 

6. Envoi de l'image créée vers le navigateur ou dans un fichier image enregistré sur le 
serveur et utilisable dans n'importe quelle page ou image au moyen de l'élément 
XHTML <img>. Les fonctions imagegif ( ), imagejpg( ) ou imagepng( ) peuvent être utili- 
sées pour cela selon le format défini à l'étape 1. Ces fonctions permettent également 
d'enregistrer les images créées sur le serveur. 

7. Libération facultative de l'espace mémoire occupé par l'image sur le serveur à l'aide 
de la fonction imagedestroy( ). 

Pour une image PNG, un script type de création d'image dynamique a la structure illus- 
trée à l'exemple 10-1. 

'•^ Exemple 1 0-1 . Script de création d'image 

<?php 

header ("Content-type: image/png") ; 

//Création du cadre 800x400 pixels 
$1dimg=imagecreate(800,400) ; 

//Création des couleurs 

$fond=imagecolorallocate($idimg,255,255,51) ; 
$noi r=1magecol oral locate($idimg, 0,0,0) ; 

//TRACES DES FORMES 

//Enregistrement de l'image dans un fichier 
imagepng($idimg, "monimage.png") ; 

//Envoi de l'image au navigateur 
imagepng($idinig) ; 
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I //Libération de l'espace mémoire 
imagedestroy($idimg) ; 
?> 

Si la page qui afficiie l'image contient d'autres éléments XHTML — comme c'est le cas 
la plupart du temps — , vous devez séparer la création de l'image de son utilisation. Vous 
avez donc deux fichiers, un fichier PHP contenant le code de création de l'image, à 
l'exemple du script de l'exemple 10-1, et un fichier XHTML ou PHP contenant le code 
XHTML d'utilisation de l'image, à l'exemple du fichier ci-dessous. Le nom du fichier 
PHP sera donné comme valeur à l'attribut src de l'élément <img />. 

<!DOCTYPE html PUBLIC ''-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title> Images dynamiques</title> 
</head> 
<body> 

<div> 

<h2> Une image dynamique </h2> 

<img src="monimage.php" alt="Mon image" /> 
</div> 
</body> 
</html> 

Toutes les images créées par la suite peuvent être affichées en utilisant ce modèle 
XHTML et en modifiant simplement la valeur de l'attribut src. 

Création du cadre de l'image 

Vous utilisez ici la fonction suivante : 

I resource imagecreate ( int larg, int haut) 

qui reçoit comme paramètres la largeur et la hauteur de l'image en pixels et retourne un 
identifiant de type resource. Ce dernier sera utilisé par toutes les fonctions intervenant 
dans la création de l'image, soit pour définir les couleurs, soit pour y effectuer des tracés, 
soit pour l'afficher ou l'enregistrer à la fin de la création. 

Par exemple, vous écrivez : 

I $idimg= imagecreate(600,200) ; 

pour créer une image de 600 pixels de large sur 200 pixels de haut. L'image est dès lors 
identifiée par la variable Sidimg. 

Ce type d'image, dite image à palette, ne contient qu'un nombre limité de couleurs, ce 
qui convient généralement aux types d'images réalisées à l'aide de la bibliothèque GD. 
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Pour créer des images en TrueColor en millions de couleurs, vous pouvez utiliser la fonc- 
tion suivante : 

[ resource imagecreatetruecol or ( int larg, int haut) 

La fonction imagei struecol or( ) permet de vérifier si une image est de ce type TrueColor. 
Elle retourne TRUE si c'est le cas et FALSE dans le cas contraire. Sa syntaxe est la suivante : 

I bool imagei struecol or ( resource $idimg) 

II est envisageable d'utiliser des images existantes pour y effectuer des ajouts, que ce soit 
des légendes ou des tracés géométriques. Il est, par exemple, possible de créer un cadre à 
partir de ces images en utilisant l'une des fonctions suivantes, selon leur format : 

resource imagecreatef romgif ( string noin_image) 

resource imagecreatef romjpeg ( string nom_image) 

resource imagecreatef rompng ( string noin_1mage) 

resource imagecreatef romwbmp ( string nom_image) 

Chacune de ces fonctions admet comme paramètre un nom de fichier ou l'URL complète 
du fichier image entre guillemets. Elles retournent un identifiant de type resource. 

Pour utiliser ces images existantes, il peut être utile d'en connaître certaines caractéristi- 
ques, comme les dimensions, afin, par exemple, d'écrire un texte centré dans l'image. 
Pour obtenir ces informations, vous pouvez faire appel à la fonction suivante : 

I array getimagesize ( string nom_iinage) 

qui retourne un tableau à sept éléments. 

Les éléments de ce tableau sont les suivants : 

• L'élément d'indice 0 contient la largeur de l'image en pixels. 

• L'élément d'indice 1 contient la hauteur de l'image. 

• L'élément d'indice 2 contient un entier qui donne le type de l'image : 1 = GIF, 
2 = JPG, 3 = PNG, 5 = PSD, 6 = BMP, 7 = TIFF (ordre des octets Intel), 8 = TIFF 
(ordre des octets Motorola), 9 = JPC, 10 = JP2, 11 = JPX, 12 = JB2, 13 = SWC et 
14 = IFR 

• L'élément d'indice 3 contient une chaîne utilisable dans l'élément HTML <img> pour 
définir ses attributs, sous la forme width="165" height="110". 

• L'élément de clé bits indique le nombre de bits utilisé pour chaque couleur pour les 
images JPEG. 

• L'élément de clé channel s vaut 3 pour les images RGB et 4 pour les images CMYK. 

• L'élément de clé mi me contient une chaîne utilisable pour créer l'en-tête correct avec la 
fonction header( ). 

En écrivant, par exemple, le code suivant : 

I print_r( getimages1ze( "mDn_image.jpg" )) ; 
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vous obtenez le résultat suivant : 



Array 
( 



[0] 165 

[1] 110 

[2] 2 

[3] width="165" height="110" 

[bits] => 8 
[charnels] 3 
[mime] image/jpeg 



Création des couleurs 

La fonction suivante définit les couleurs qui seront utilisées pour le fond de l'image et les 
tracés successifs : 

■ int imagecol oral 1 ocate ( resource $idiing, int R, irt G, int B) 

Elle crée une couleur pour l'image identifiée par $idimg. Les paramètres R, G et B sont les 
valeurs entières en base 10 (donc de 0 à 255) et non en hexadécimal (de la forme FF), 
comme en XHTML. 

Chaque valeur correspond à l'intensité des couleurs (Red, Green, Blue) qui composent la 
teinte désirée. La fonction retourne également un identifiant entier, qui est récupéré dans 
une variable et qui servira à identifier la couleur dans les fonctions de tracé. 

Par exemple, vous écrivez : 

I $orarge=imagecolorallocate($idimg, 255, 128,0) ; 

pour créer la couleur orange qui sera identifiée par la variable $orange. 



Couleur de fond 

La première couleur créée devient automatiquement la couleur de fond de l'image. Il faut donc veiller à 
l'ordre de création des couleurs. 



Pour avoir un fond transparent, vous définissez la couleur de fond comme étant transpa- 
rente à l'aide de la fonction : 

I int imagecol ortransparent ( resource Sidimg, int $couleur) 

qui permet d'obtenir une image de forme quelconque, le cadre rectangulaire n'étant plus 
visible. La couleur de transparence n'est bien sûr plus utilisable pour aucun tracé, sauf 
pour créer des effets particuliers. 

II est possible de définir n'importe quelle couleur comme transparente. Le code suivant 
définit le vert comme transparent : 
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I $vert=imagecol oral locateCSidimg, 0,128,0) ; 
imagecol ortransparent($iclimg,$vert ) ; 

Tous les pixels verts laissent ainsi voir la couleur de fond. 

Tracé de formes géométriques 

Tous les tracés de formes géométriques se font en précisant des coordonnées relativement 
au cadre qui a été défini par la fonction imagecreate( ). L'origine des coordonnées est le 
sommet supérieur gauche du cadre, le sens positif des ordonnées étant vers le bas. 

Tracé de points 

Vous pouvez tracer un point de la taille d'un pixel en précisant ses coordonnées dans le 
cadre à l'aide de la fonction suivante : 

I int imagesetpixel ( resource Sidiing, int x, int y, int $couleur) 

L'exemple 10-2 utilise cette fonction pour réaliser le tracé d'une fonction classique. La 
structure du script est conforme au modèle proposé précédemment et n'a pas besoin d'être 
détaillée. Après la création d'une couleur de fond et d'une couleur de tracé (repères O 
et ©), une boucle trace des points dont l'ordonnée $y est calculée à l'aide de la fonction 
sinus. La mise à l'échelle des coordonnées et le décalage d'origine sont réalisés dans le 
calcul de $y (repère 0). Le double appel à la fonction imagesetpixel ( ) permet d'avoir un 
trait plus épais (repères O et 0). L'image est d'abord enregistrée dans le fichier 
sinus.png (repère ©) puis envoyée au navigateur (repère ©), et la mémoire est libérée 
(repère ©). 

<^ Exemple 1 0-2. Tracé d'une sinusoïde point par point. 

<?php 

header ("Content-type: image/png" ) ; 
$idimg=imagecreate(800,400) : 

$fond=imagecol oral 1 ocate($idinig,255,255,51) ; <— O 
$noi r=imagecol oral locate($idinig,0,0,0) ; <— © 
for($x=0:$x<800:$x++) 
{ 

$y=-200*sin($x/100)+200: <-© 
imagesetpixel ($idimg,$x,$y,$noir) ; <— O 
imagesetpixel ($idimg,$x,$y+l ,$noi r ) ; <— © 

} 

imagepng($idimg, "sinus .png" ) ; <— © 
imagepng($idimg) ; <— © 
imagedestroy ($idimg) ; <— © 
?> 

La figure 10-1 illustre le résultat obtenu en appelant le fichier PHP dans un document 
XHTML contenant la ligne de code suivante : 

I <img src="image2.php" border="r' alt="La fonction Sinus" /> 
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Figure 10-1 

Tracé de la fonction sinus point par point 



Tracé de droites 

Le tracé de segment de droite se réalise à l'aide de la fonction imagelineO, dont la 
syntaxe est la suivante : 

I int imageline (resource Sidimg, int xl, int yl, int x2, int y2, int Scouleur) 

Les couples (xl.yl) et (x2,y2) sont respectivement les coordonnées de l'origine et de 
l'extrémité du segment. 

Par défaut, l'épaisseur des lignes est de un pixel, mais vous pouvez modifier cette valeur 
en utilisant la fonction suivante : 

I bool imagesetthickness (resource Sidimg, int N) 

dans laquelle N définit la largeur de trait en pixel. Elle retourne TRUE si le paramétrage est 
bien réalisé, FALSE sinon. 

L'exemple 10-3 définit une largeur de trait de deux pixels (repère O) puis réalise, dans 
un cadre de 800 sur 400 pixels, une série de lignes dont l'origine est commune — le 
point de coordonnées (400,399) — et dont l'extrémité est une variable de coordonnées 
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($x,0). La variable $x est incrémentée de 10 unités dans la boucle for (repère 0). Le 
tracé des lignes est effectué avec la couleur noire (repère 0). 

Vous obtenez une sorte d'éventail, comme l'illustre la figure 10-2. 
'•^ Exemple 1 0-3. Tracé de lignes 

<?php 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400) : 

$fond=imagecol oral 1 ocate($idinig,255,255,51) ; 

$noi r=imagecol oral locate($idimg, 0.0,0) ; 

//Définition de l'épaisseur de trait de 2 pixels 

iiiiagesetthickness($idimg,2) ; <— O 

//Tracé des droites 

for($x=0:$x<800:$x+=10) <-© 

{ 

imagel ine ($idimg, 400,399, $x.O,$noir); <— 0 

} 

imagepng($idimg, "rayons .png" ) ; 
imagepng($idimg) ; 
imagedestroy($idimg) ; 
?> 




Figure 10-2 

Tracé de lignes droites 
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Tracé de rectangles et de carrés 

Pour tracer des rectangles et des carrés, vous disposez de la fonction suivante : 

I int imagerectangl e (resource $idiing, int xl, int yl, int x2, int y2,int Scouleur) 

qui trace un rectangle ayant pour sommet supérieur gauche le point (xl.yl) et pour 
sommet inférieur droit le point ( x2 , y 2 ) . Le tracé est réalisé avec la couleur précisée par le 
paramètre Scouleur. 

Pour tracer des rectangles pleins avec une couleur donnée, vous disposez de la fonction 
suivante, à la syntaxe identique : 

Iint imagefilledrectangle (resource $idimg, int xl, int yl, int x2, int y2, 
^int Scouleur) 

L'exemple 10-4 effectue le tracé de rectangles imbriqués à l'aide d'une boucle for 
(repère Q) puis d'un rectangle plein de couleur rouge au centre (repère ©). Comme les 
précédents, il enregistre l'image sur le serveur (repère 0) puis l'envoie au navigateur 
(repère Q). 

'•^ Exemple 10-4. Tracé de rectangles 

<?php 

header ("Content-type: image/png"); 
$idiirg=imagecreate(800 ,400) ; 
$fond=iniagecolorallocate($idiing,255,255,51) : 
$rouge=imagecol orall ocate($idinig,255,0,0) ; 
//Définition de l'épaisseur de trait de 3 pixels 
iniagesetthickness($idinig,3) ; 
//Tracé des rectangles 
for($i=3;$i<100;$i+=20) 
{ 

iniagerectangle($idimg,$i .$i ,800-$i ,400-$i ,$rouge); <— O 

} 

//Tracé d'un rectangle plein 

iniagefilledrectangle($idimg,100,100,700,300,$rouge); <— 0 
imagepng($idimg, "rectangl es .png" ) ; <— © 
1magepng($idiing) : <— O 
1magedestroy($idiing) ; 
?> 

La figure 10-3 permet d'apprécier le résultat affiché. 
Tracé de polygones 

La fonction suivante permet de tracer des polygones avec un nombre quelconque de 
côtés : 

I Int Imagepolygon (resource $1dimg, array $tab, Int N, Int Scouleur) 
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Figure 10-3 

Tracé de rectangles 



Contrairement au tracé des rectangles, vous n'énumérez pas les coordonnées des 
sommets. Celles-ci sont passées sous la forme d'un tableau $tab, dont les éléments sont 
une suite d'abscisses et d'ordonnées. Assurez-vous qu'il y ait un nombre pair de coor- 
données. Le paramètre N indique le nombre de sommets, ce qui permet de refermer la 
figure sans donner à nouveau les coordonnées du premier point. 

La variante suivante, dont la syntaxe est identique, permet de tracer des polygones pleins : 

I int imagefilledpolygon (resource $idimg, array $tab, int N, int $couleur) 

L'exemple 10-5 définit un tableau de huit éléments représentant les coordonnées de 
quatre sommets (repère Q) puis trace le quadrilatère correspondant (repère 0). Les 
coordonnées peuvent être passées en définissant le tableau directement comme second 
paramètre de la fonction (repère ©), ici pour tracer un triangle. 

'•^ Exemple 1 0-5. Tracé de polygones 

<?php 

header ("Content-type: image/png" ) ; 
$idimg=imagecreate(800,400) ; 
$fond=imagecol oral 1 ocate($idimg,255,255,51) : 
$noi r^imagecol oral 1ocate($idinig,0,0,0) ; 
$blanc=imagecolorallocate($idimg,255,255,255) ; 
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//Définition de l'épaisseur de trait de 3 pixels 

imagesetthickness($idimg,3) ; 

//Coordonnées du quadrilatère 

$tab=array (100.50.500.100.750.300.50.350); <-© 

//Tracé du quadrilatère 

iniagepolygon($idimg,$tab.4.$noi r) ; <— 0 

//Tracé du triangle plein 

i magef il ledpolygon($idimg.array (150. 80,500. 150,250,310) ,3.$blanc) ; 

imagepng($idinig, "polygon.png") ; 

imagepng($idiing) ; 

imagedestroy($idiing) ; 

?> 

Le résultat affiché est illustré à la figure 10-4. 
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Tracé de polygones 



Tracé d'arcs, de cercles et d'ellipses 

Pour tracer des arcs de cercle ou des ellipses, vous disposez de la fonction imagearcO, 
dont la syntaxe est la suivante : 

Iint imagearc (resource Sidimg, int Xc, int Yc. int Larg. int Haut, int Angl. 
^int Ang2. int Scouleur) 
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Les paramètres Xc et Yc sont les coordonnées du centre. Larg et Haut représentent la 
largeur et la hauteur (égaux pour un cercle). Angl et Ang2 sont des angles en degrés, qui 
permettent d'indiquer la portion de cercle ou d'ellipse qui sera représentée. L'origine des 
angles est la position horaire 3 heures, et le sens positif est horaire. 

Pour créer des secteurs circulaires ou elliptiques pleins, vous utilisez la fonction 
imagef i 1 ledarc( ), dont la syntaxe est quasiment identique : 

k bool imagef i 1 1 edarc ( resource $idimg, int Xc, int Yc, int Larg, int Haut, 
I ^int Angl, int Ang2, int Scouleur, int style) 

Le paramètre supplémentaire styl e est une constante entière, qui peut prendre les valeurs 
suivantes : 

• IMG_ARC_PIE : le secteur est plein, et les rayons sont tracés. Vous obtenez un camem- 
bert. 

• IMG_ARC_N0FI LL : seul le contour est tracé sans les rayons. Dans ce cas, vous utilisez de 
préférence imagearcO. 

• IMG_ARC_CHORD : les rayons et la corde qui relie les extrémités de l'arc sont tracés, et le 
complément du secteur tracé est rempli. Vous obtenez un triangle isocèle dont vous 
connaissez l'angle au sommet. 

Pour tracer des cercles ou des ellipses complets, il est plus simple d'utiliser la fonction 
suivante : 

Iint imageellipse (resource $idimg, int Xc, int Yc, int Larg, int Haut, 
^int Scouleur) 

dont la syntaxe est similaire à imagearcO. 

Pour effectuer le même tracé plein, vous disposez aussi de la variante suivante : 

L bool imagefilledellipse (resource $idimg, int Xc, int Yc, int Larg, int Haut, 
I ^Scouleur) 

L'exemple 10-6 utilise ces fonctions pour tracer successivement deux cercles concen- 
triques (repère O), un secteur elliptique plein (repère 0), une ellipse (repère 0) et une 
ellipse pleine (repère O). 

'•^ Exemple 1 0-6. Tracé d'arcs et d'ellipses 

<?php 

header ("Content-type: image/png"); 
$idimg=imagecreate(800,400) ; 
$fond=imagecol oral 1 ocate($idimg,255,255,51) ; 
$noi r^imagecol oral locate($idimg, 0,0,0) ; 
$rouge=imagecol oral locate($idimg, 255,0,0) ; 
//Tracé d'arcs 

imagearc($idimg,200,100,180,180,180,360,$noir) : <— Q 
imagearc($idimg,200,100,140,140,180,360,$noir) : 

imagef i 11 edarc($idimg, 500, 200, 480, 300,0, 290, $rouge,IMG_ARC_PIE): <-© 
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//Tracé d'ellipses 

imageellipse ($idinig,200,150,100,50,$noir); <— © 
imagefilledellipse ($idimg.l20.300,200,80,$rouge) ; <— O 
imagepng($idiing, "cercle. png" ) ; 
imagepng($idiing) ; 
imagedestroy($idimg) ; 
?> 

La figure 10-5 illustre les résultats obtenus. 
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Figure 10-5 

Tracé de cercles et d'ellipses 



Remplissage de surfaces 

Vous avez vu comment créer des surfaces pleines quand il s'agit de rectangles, de poly- 
gones ou de cercles. Quand il s'agit de remplir des formes quelconques limitées par un 
contour fermé avec une couleur précise, utilisez la fonction suivante : 

I int imagefill (resource $idimg, int x, int y, int Scouleur) 

Les coordonnées (x,y) passées en paramètre sont celles d'un point quelconque de l'inté- 
rieur de la surface à remplir. 

Vous avez également la possibilité de remplir une surface à l'aide d'un motif constitué 
d'une image existante, qui se répète autant de fois que nécessaire. Cette fonction est très 
utile pour réaliser une image de fond dans un document XHTML. 
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Commencez par charger l'image du motif, et récupérez son identifiant dans une variable, 
comme ci-dessous : 

I $idmotif=imagecreatef romgifC "php5_logo.gif" ) ; 

Utilisez ensuite la fonction suivante : 

I int iiTiagesetti 1 e ( resource $idimg, resource $idmotif) 

qui définit l'image identifiée par $i dmoti f comme motif de remplissage. La valeur retour- 
née par cette fonction est du même type qu'un identifiant de couleur. Pour utiliser ce 
motif de remplissage, passez à la place du nom de la couleur le paramètre IMG_COLOR_ 
TILED, qui est une constante. 

Par exemple, vous écrivez le code suivant pour créer un rectangle rempli avec le motif 
choisi : 

I imagefilledrectangle($idimg.l00.300.200.390.IMG_C0L0R_TILED): 

L'exemple 10-7 met en œuvre ces fonctions de remplissage. Le tracé de deux arcs de 
cercle (repères O et 0) crée une surface qui est remplie en noir (repère 0). Vous 
chargez ensuite l'image GIF du logo PHP 5 identifiée par la variable $idlogo 
(repère Q). Cette image permet de définir le motif de remplissage au moyen de la 
fonction imagesettile( ) (repère©). Le passage de l'argument IMG„COLOR„TILED à 
la fonction imagefilledarc( ) permet de remplir la surface créée avec l'image du logo 
(repère 0). 

'•^ Exemple 10-7. Remplissage de surfaces 

<?php 

header ("Content-type: image/png"); 
$idimg=imagecreate(800,400) ; 
$fond=imagecol oral! ocate($idimg,255,255,51) ; 
$noi r=imagecol oral locateCSidimg, 0,0,0) ; 
//Tracé d'arcs 

imagearc($idimg,50,200,180,180,270,90,$noir) : <— Q 

imagearc($idimg,150,200,180,180,90,270,$noir); 

//Remplissage en noir de la zone 

Imagef 1 11 ( $i di mg , 100 , 200 , $no1 r ) ; ^0 

//Tracé de camembert rempli avec une image 

$1dl ogo=1magecreatef romgif ( "php5_l ogo.gif " ) ; <— O 

$mot1f=imagesett11e($id1mg,$idlogo) : <— 0 

1magefilledarc($idimg,500,200,480,300,30,290,IMG_COLOR_TILED,IMG_ARC_PIE): ^0 

1magepng($idimg, "rempl issage.png" ) ; 

1magepng($id1mg) ; 

1magedestroy($id1mg) ; 

?> 



La figure 10-6 illustre le résultat de ce script. 
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Figure 10-6 

Remplissage de surfaces 

Écriture de texte 

Les tracés géométriques que vous venez de voir peuvent être utilement complétés par des 
légendes. L'extension GD offre la possibilité d'utiliser des polices ordinaires incorpo- 
rées, ainsi que des polices TrueType. Ces dernières nécessitent la présence des fichiers 
correspondants, avec l'extension .ttf, sur le serveur. 

La fonction imagestring( ) permet d'utiliser les polices de PHP. Sa syntaxe est la 
suivante : 

Iint imagestring (resource $idimg, int taille, int x, int y, string $ch, 
^int $couleur) 

La fonction affiche dans l'image le texte de la chaîne $ch à la position (x.y) et avec la 
couleur précisée. Le paramètre tai 1 1 e définit le corps de la police utilisée, de 1 à 5. 

Pour afficher du texte verticalement de bas en haut, utilisez la fonction : 

Iint imagestringup (resource $idimg, int taille, int x, int y, string $ch, 
^int Scouleur) 

dont la syntaxe est identique. 

L'éventail de polices disponibles dans l'extension GD est très limité. Pour afficher des 
caractères dans des tailles ou des polices plus variées, il est préférable d'utiliser des polices 
TrueType à l'aide de la fonction suivante : 

Iarray imagettftext (resource Sidiing, int taille, int angle, int x, int y, 
^int $couleur, string noin_police, string $ch) 
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Cette fonction vous permet de choisir la taille (comme dans un traitement de texte) et 
l'angle d'inclinaison du texte par rapport à l'horizontale, exprimé en degrés. Le nom du 
fichier de la police doit être passé en paramètre dans une chaîne en y incluant son exten- 
sion .ttf. 

Pour utiliser des polices FreeType 2, choisissez la fonction suivante, dont la syntaxe est 
identique : 

Iarray imagefttextC resource $idimg. int taille, int angle, int x, int y, 
*int $couleur, string noni_police, string $ch) 



Transferts côté serveur 

La configuration PHP du serveur doit évidemment accepter de traiter les polices TrueType. Pour le vérifier, 
il vous suffit d'afficfier les informations fournies par la fonction plipinfo( ) dans la rubrique GD. Il vous 
faut de plus obligatoirement transférer le fichier . ttf sur le serveur. 



L'exemple 10-8 réalise l'affichage de texte dans une image en utilisant tout d'abord les 
cinq tailles de police PHP (repères Q à 0) puis en traçant un texte verticalement 
(repère ©) et enfin au moyen de polices TrueType horizontales (repères Q et ©) ou 
inclinées (repère 0). La figure 10-7 illustre le résultat obtenu. La pauvreté des polices 
PHP est évidente en comparaison des polices TrueType. 

Exemple 10-8. Création de texte dans une image 

I 

header ("Content-type: image/png" ) ; 

$idimg=imagecreate(800,400) ; 

$fond=imagecol orall ocate($idimg,255,255,51) : 

$noi r^imagecol oral locate($idimg, 0,0,0) ; 

$orange=imagecol oral locate($idimg ,255 ,128,0) ; 

imagefilledrectangle($idinig,50,100,220,390,$orange) : 

//Texte avec les polices PHP 

imagestring($idimg, 5, 55, 100. "RECTANGLE ORANGE", $noir); <-© 
imagestring($idiiiig, 4, 55, 120, "RECTANGLE ORANGE", $noir); <-0 
imagestring($idimg, 3, 55, 140, "RECTANGLE ORANGE", $noir); <— © 
imagestring($idimg, 2, 55, 160, "RECTANGLE ORANGE", $noir); <— O 
imagestring($idimg, 1,55, 180, "RECTANGLE ORANGE", $noir); <— 0 
imagest ri ngup($idimg, 5, 195, 300, "RECTANGLE ORANGE" , $noi r) ; <— © 
//Texte avec des polices TrueType 

imagettftext ($idimg, 30, 0,300, 100, $noir, "El ephnti .ttf " , " PHP 5 et 
^MySQL" ): <-0 

imagettftext ($idimg, 35, 0,300, 240, $noi r, "Elephnt.ttf " , " EYROLLES" ) ; <-© 

imagettftext ($idimg, 30,10,300,200,$noir, "Elephnti .ttf", 

^" Engels" ) ; <— 0 

imagepng($idimg) ; 

imagedestroy($idimg) ; 

?> 
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Figure 10-7 

Écriture de texte dans une image 

Utilisation pratique 

L'exemple 10-9 illustre une fonction complète de création d'image à l'aide de la bibliothè- 
que GD. La fonction crée dynamiquement un histogramme à partir de données externes. 
Celles-ci peuvent provenir d'une base de données ou d'un fichier XML par exemple. 

La fonction possède les caractéristiques suivantes, qui la rendent utilisable dans de 
multiples cas : 

• Les dimensions de l'image sont paramétrables par le biais des variables ($x,$y) 
(repère O). La taille de l'image est créée en fonction de ces valeurs (repère 0). 

Les données pour la hauteur des rectangles de l'histogramme sont en nombre variable. 
Elles sont passées à la fonction sous forme de tableau ($donn, repère O troisième para- 
mètre). 

• Chaque rectangle de l'histogramme comporte une légende particulière. L'ensemble de 
ces légendes est passé sous forme de tableau ($texte, repère O quatrième paramètre). 

• L'ensemble de l'histogramme occupe la largeur de l'image moins 20 pixels et 80 % 
de la hauteur totale pour obtenir des marges (repère 0). En fonction du nombre 
d'éléments du tableau $donn, vous calculez le nombre de colonnes (repère 0) et la 
largeur de chacune d'elles (repère 0). 
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• Une boucle for effectue le calcul des coordonnées des rectangles en fonction des 
données et du coefficient de mise à l'échelle (repère Q). Une seconde boucle trace les 
rectangles en noir, les remplit en jaune et écrit le libellé de chaque colonne (repère 0). 

• L'histogramme a un titre général ($ti tre, repère O cinquième paramètre), qui est écrit 
avec une police TrueType (repère 0). 

• La fonction n'envoie pas l'image créée directement au navigateur, à la différence 
des exemples précédents, mais enregistre un fichier image sous le nom histo.png 
(repère ©)• Celui-ci est utilisable dans une page XHTML contenant l'élément <img />. 

Exemple 10-9. Fonction de création d'un histogramme dynamique 

<?php 

function histo($x,$y,$donn,$texte,$titre) <— O 
{ 

$image=iiïiagecreate($x,$y) ; <— 0 

//la première couleur déclarée est la couleur de fond 
$ocre=imagecol oral locate($i mage, 195, 155, 125) ; 
$blanc=imagecolorallocate($i mage, 255, 255, 255) ; 
$bleu =imagecolorallocate($i mage, 50, 0,255) ; 
$noir =imagecolorallocate($i mage, 0,0,0) ; 
$jaune=imagecolorallocate($image,255,255,00) ; 
$nbcol=count($donn) ; <— 0 
$maxi=0: 

//Recherche de la valeur maxi 
for($i=0:$i<$nbcol :$i++) 
{ 

$maxi = max($maxi ,$donn[$i]); <— 0 

) 

//coefficient d'échelle 
$coeff = ($y*0.8)/ $maxi ; ^0 
$X0 = 10; 
$Y0 = $y-50: 

$larg = ($x-20)/$nbcol ; <-0 
//coordonnées des sommets des rectangles 
for($i=0:$i<$nbcol :$i++) ^0 
{ 

$tabX[$i] = $X0 + $larg*$i ; 
$tabY[$i] = $Y0 - $coef f*$donn[$i ] ; 

} 

//tracé des rectangles 
for($i=0:$i<$nbcol :$i++) <— 0 
{ 

//tracés des rectangles en noir 

imagerectangle($image,$tabX[$i],$tabY[$i],$tabX[$i]+$larg,$YO,$noir); 
//remplissage des rectangles en jaune 
imagefill ($image,$tabX[$i]+5,$Y0-5,$ jaune) ; 
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//Écriture des données au dessus des rectangles 

imagettftext($image,15,0,$tabX[$i]+20.$tabY[$i]-5,$noir."vivaldii .ttf", 
^$donn[$i]): 

//Écriture des jours en bas des rectangles 

imagettftext($image,15,0,$tabX[$i]+20,$y-55,$bleu,"elephnti .ttf". 
*»$texte[$i]): 

} 

//Écriture du titre de l'histogramme en bas 

imagettftext($image, 20,0. 200, $y-23, $blanc, "elephnti .ttf " ,$titre) ; <— Q 
//enregistre 1 'image 
imagepng($image,"histo.png") ; <— (J) 

//Libère la mémoire 
imagedestroy($image) ; 

} 

?> 

L'exemple 10-10 utilise cette fonction pour créer une page HTML incluant un script 
PHP qui incorpore le code image9.php de la fonction histoO (repère O) puis définit le 
tableau de données et les légendes contenues dans les variables $donn, $texte et $titre 
(repères Q, Q et ©). L'appel de la fonction histo( ) avec ces paramètres crée l'image 
histo.png (repère 0). Celle-ci est appelée dans l'attribut src de l'élément <img> du docu- 
ment HTML (repère ©). 

Exemple 10-10. Utilisation de la fonction 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title> Histogramme dynamique </title> 
</head> 
<body> 
<div> 

<h2>Résultats des ventes de la semaine</h2> 
<?php 

//Utilisation de la fonction 
include("image9.php"); <— O 

$donn= array(850, 2500, 4050, 2730, 2075, 2590, 1450); <-© 

$texte = array( "Lun" , "Mar" , "Mer" , "Jeu" , "Ven" , "Sam" , "Dim" ) ; <— © 

$titre = "Ventes hebdomadaires PHP 5";<— © 

histo(700,450,$donn,$texte,$titre) : <— 0 

?> 

<img src="histo.png" alt="Ventes" /> <— © 
</div> 
</body> 
</html> 
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La figure 10-8 illustre l'histogramme créé par la fonction histoO avec les données de 
l'exemple 10-10. 
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Figure 10-8 

Histogramme des ventes 
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L'extension Ming et les animations Flash 

Dans le domaine du graphisme, PHP dispose, en plus du module GD, d'un module Ming 
installé d'office dans WampServer et sur les serveurs d'hébergeurs comme Ovh. Ce 
module permet la création dynamique d'animations au format Flash (avec l'extension 
.swf). Il est utilisable aussi bien sous Windows que sous Linux et permet, à l'instar du 
logiciel Flash d'Adobe, de gérer des formes, des boutons, des images mais aussi des 
textes et de répondre aux actions des utilisateurs dans les animations réalisées. Il permet 
également de gérer la diffusion de vidéos et de fichiers sons au format MP3. 

Le module Ming est entièrement orienté objet et met à votre disposition 18 classes 
auxquelles sont associées au total plus de 160 méthodes. La pagination de ce livre ne 
nous permet pas d'envisager sérieusement une étude de ce module mais, si le sujet vous 
intéresse, vous trouverez en bonus, sur le site du livre, à l'adresse http://www.funhtml.com/ 
php5/C10/Ming une initiation à l'utilisation des classes de Ming ainsi que des exemples de 
création de fichiers Flash. 



Mémo des fonctions 
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array gd_info (void ) 

Retourne les informations concernant la version GD du serveur, 
array getimagesize ( string nom_image) 
Retourne des informations sur l'image. 

int imagearc (resource $idiing, int Xc, int Yc, int Larg, int Haut, int Angl, int Ang2, int 
$couleur) 

Crée un arc de cercle ou une ellipse de centre (Xc.Yc). 

int imagecol oral 1 ocate ( resource $idimg, int R, int G. int B) 

Crée une couleur RGB et retourne un identifiant. 

int imagecolorat ( resource $idirig, int X, int Y) 

Retourne l'Identifiant de la couleur du pixel situé en ( X . Y ) . Pour une image TrueColor, retourne le code de couleur RGB. 
int imagecol ordeal 1 ocate ( resource $idimg. int $couleur) 
Supprime la couleur dont l'Identifiant est $coul eur. 

bool imagecol orset ( resource $idimg, int $couleur, int R, int G, int B) 

Modifie la couleur dont l'identifiant est donné et retourne TRtJE. 

array imagecolorsforindex ( resource $idimg, int $couleur) 

Retourne les valeurs RGB de la couleur précisée dans un tableau. 

int imagecol orstotal ( resource $idimg) 

Retourne le nombre de couleurs de l'image. 

int imagecol ortransparent ( resource $idimg, int $couleur) 
Définit la couleur de transparence. 

int imagecopy (resource $idimg2, resource $idimgl, int x2, int y2, int xl, int yl, int largl, 
int tiautl) 

Copie la partie de l'image 1 commençant au point (xl ,yl), de largeur 1 argl et de hauteur hautl, dans l'image 2 au 
point (x2,y2). 

int imagecopy (resource $idimg2, resource $idimgl, int x2, int y2, int xl, int yl, int largl, 
int tiautl, int transp) 

Identique à la précédente mais en fusionnant les deux images en fonction de la transparence affectée à l'image 2 (de 0 
à 100). 

resource imagecreate (int larg, int tiaut) 
Crée une nouvelle image vide de dimensions 1 arg x tiaut pixels, 
resource imagecreatefromgif (string nom_image) 
Ouvre une image GIF. Le paramètre peut être une URL. 
resource imagecreatef romjpeg (string nom_image) 
Ouvre une image JPEG. Le paramètre peut être une URL. 



304 



PHP 5 



resource imagecreatef rompng (string noiii_image) 

Ouvre une image PNG. Le paramètre peut être une URL. 

resource imagecreatef romwbmp (string nom_image) 

Ouvre une image WBMR Le paramètre peut être une URL. 

resource imagecreatetruecolordnt larg, int tiaut) 

Crée une nouvelle image TrueCoior vide de dimensions 1 arg x haut pixels. 

int imagedestroy (resource $idimg) 

Libère la mémoire occupée par l'image identifiée par $idimg. 

int imageel 1 i pse (resource $idimg, int Xc, int Yc, int Larg, int Haut, int Scouleur) 
Crée une ellipse ou un cercle de centre (Xc,Yc). 

int imagefill ( resource $idimg, int X, int Y, int $couleur) 
Remplit la zone contenant le point ( X , Y ) avec la couleur donnée. 

bool imagef i 11 edarc ( resource $idimg, int Xc, int Yc, int Larg, int Haut, int Angl, int Ang2, 
int $couleur, int style) 

Trace un secteur circulaire de centre (Xc,Yc) rempli avec la couleur donnée. 

bool imagef i 1 1 edel 1 ipse (resource $idimg, int Xc, int Yc, int Larg, int Haut,$couleur) 

Trace une ellipse de centre (Xc,Yc) remplie avec la couleur donnée. 

int imagef i 1 1 edpolygon (resource $idimg, array $tab, int N, int locuteur) 

Trace un polygone à N côtés dont les coordonnées des sommets sont listés dans le tableau $tab et le remplit avec la 
couleur donnée. 

int imagef i 1 1 edrectangl e (resource $idimg, int xl, int yl, int x2, int y2, int $couleur) 

Trace un rectangle rempli avec la couleur donnée. 

int imagefonttieight ( int $idfont) 

Retourne la tiauteur de la fonte en pixels. 

int imagefontwidth ( int $idfont) 

Retourne la largeur de la fonte en pixels. 

array imagefttext (resource lidimg, int taille, int angle, int x, int y, int $couleur, string 
nom_police, string $cti) 

Affiche un texte en utilisant une police FreeType 2. 

int imagegd2 (resource $idimg [, string nom_fictiier]) 

Envoie l'image GD2 vers le navigateur ou dans un ficfiier sur le serveur. 

int imagegif ( resource $idimg [, string nom_ficfiier] ) 

Envoie l'image GIF vers le navigateur ou dans un fichier sur le serveur 

int imageinterl ace (resource $idimg [, int N]) 

Définit l'entrelacement de l'image si W vaut 1 . Retourne l'état d'entrelacement. 
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bool imagei struecol or (resource $idimg) 
Retourne TRUE si l'image est en TrueColor. 

int imagejpeg ( resource $idimg [, string nom_fichier [, int N]]) 

Envoie l'image JPEG vers le navigateur ou dans un fichier sur le serveur. N est le facteur de qualité de 0 à 100 (75 par 
défaut). 

int imageline ( resource $idimg, int XI, int Yl, int X2, int 12, int Scouleur) 

Trace un segment entre les points (XI, Yl) et (X2,Y2) avec la couleur donnée. 

int imagepng ( resource $idimg [, string noin_f i ctiier] ) 

Envoie l'image PNG vers le navigateur ou dans un fichier sur le serveur. 

int imagepolygon (resource $idimg, array $tab, int N, int $couleur) 

Trace un polygone à W côtés dont les coordonnées des sommets sont listés dans le tableau $tab. 

int imagef i 1 1 edrectangl e (resource $idiing, int XI, int Yl, int X2, int Y2, int $couleur) 

Trace un rectangle. 

int imagesetpixel (resource $idimg, int X, int Y, int $couleur) 

Trace un pixel au point ( X , Y ) de la couleur donnée. 

bool imagesetthi ckness (resource $idimg, int N) 

Définit la largeur de trait des tracés des figures géométriques. 

int imagesettile (resource $idimgl, resource $idiiiig2) 

Définit l'image $idimg2 comme motif de remplissage de $idimgl. Les fonctions de remplissage doivent utiliser la cons- 
tante IMG_COLOR_TILED comme couleur. 

int imagestring (resource $idimg, int font, int x, int y, string s, int $couleur) 

Écrit la chaîne $ch avec la taille font dans l'image $idimg à la position (x,y). 

int imagestringup (resource $idinig, int font, int x, int y, string s, int $couleur) 

Identique à imagestring( ) mais avec le texte écrit verticalement. 

int imagesx (resource $idimg) 

Retourne la largeur de l'image en pixels. 

int imagesy (resource $idimg) 

Retourne la hauteur de l'image en pixels. 

array imagettftext (resource Sidimg, int taille, int angle, int x, int y, int $couleur, string 
nom_police, string $ch) 

Affiche un texte en utilisant une police TrueType. 

int imagetypes (void ) 

Retourne les types d'image supportés par la bibliothèque GD. Les valeurs sont 1 pour GIF, 2 pour JPG, 4 pour PNG et 8 
pour WBMP Les valeurs se cumulent (exemple 5 pour GIF et PNG). 

int imagewbmp (resource $idimg [, string noin_fichier, int $couleur]]) 

Envoie l'image WBMP vers le navigateur ou dans un fichier sur le serveur. Le dernier paramètre donne la couleur de fond. 
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Exercices 

Exercice 1 

Créez une image de 500 x 300 pixels avec une couleur de fond rouge. Écrivez un texte de 
bienvenue en blanc avec une police PHP. 

Exercice 2 

Créez une image de 400 x 200 pixels avec un fond transparent. Dessinez une suite de 
rectangles emboîtés de couleurs différentes. 

Exercice 3 

Créez une image de 800 x 600 pixels avec une couleur de fond verte. Tracez un trapèze 
isocèle rempli de jaune, et écrivez le mot « trapèze » au centre. 

Exercice 4 

Créez une image de 601 x 601 pixels avec un fond transparent. Déterminez le centre O 
de l'image, et tracez des cercles concentriques centrés en O avec des rayons variant de 
30 pixels jusqu'au bord de l'image. Attribuez à chaque cercle une couleur différente. 

Exercice 5 

Créez une image à partir d'un fichier JPEG existant sur votre poste. Écrivez une légende 
de votre choix, d'abord en noir puis dans une autre couleur, en la décalant de 1 pixel en 
X et en Y afin de créer un effet d'ombre. 

Exercice 6 

Créez une image de 1 024 x 768 pixels. Tracez la fonction f (x)=x^ avec x compris entre 
- 50 et + 50, et tracez les axes. Le tracé doit occuper la plus grande surface possible de 
l'image. 
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Vous avez vu au chapitre 6 que les formulaires étaient l'outil privilégié pour recueillir les 
informations en provenance des visiteurs du site et que ces informations étaient récupé- 
rées dans des variables créées côté serveur. Le problème avec ces données est qu'elles 
sont volatiles. Sitôt le script terminé, elles sont perdues. Quand elles présentent un intérêt 
qui va au-delà de la simple connexion en cours, il faut envisager les moyens de les réuti- 
liser plus tard. 

La solution la plus simple à ce problème consiste à enregistrer les données sur le serveur 
dans un fichier, généralement de type texte. Ce type de stockage est principalement 
utilisé pour des quantités de données de taille modeste et quand il n'est pas nécessaire 
d'effectuer par la suite des recherches complexes parmi elles. Dans le cas contraire, il 
faut avoir recours à une base de données spécialisée, comme MySQL ou SQLite, qui 
permet d'effectuer des recherches « pointues ». 

L'utilisation des bases de données étant relativement complexe et lourde pour les débu- 
tants, il ne faut pas négliger le stockage de données dans des fichiers pour les cas simples. 
Vous vous intéresserez surtout dans ce chapitre aux fichiers au format texte brut, à 
l'extension .txt. Les méthodes présentées s'appliquent néanmoins aux autres types de 
fichiers. Le chapitre 19 est consacré à la façon de lire les fichiers XML, pour lesquels 
PHP fournit désormais une extension spécialisée, et aux échanges réciproques de 
données qu'il est possible de réaliser entre une base de données comme MySQL et un 
fichier au format XML. 

Le présent chapitre détaille les techniques suivantes : 

• ouverture d'un fichier existant ou création d'un nouveau fichier puis sa fermeture ; 

• écriture dans le fichier ; 

• formatage des données ; 
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• lecture des données ; 

• recueil d'informations sur les fichiers ; 

• modification des fichiers. 

Création, ouverture et fermeture d'un fichier 

Il peut être utile dans certaines circonstances de créer un fichier vide de tout contenu 
mais ayant une existence physique sur le serveur. Si vous envisagez d'écrire des données 
correspondant à plusieurs connexions différentes dans un même fichier, par exemple, il 
vous faut commencer par créer un fichier vide, non sans contrôler qu'il n'existe pas 
encore. Vous y ajoutez ensuite les données en provenance de l'utilisateur. 

Pour faire cela, vous pouvez détourner la fonction touch( ) de sa vocation initiale, qui est 
de définir la date de la dernière modification d'un fichier. Si le fichier n'existe pas, cette 
fonction le crée et lui affecte la date passée en deuxième argument sous la forme d'un 
timestamp UNIX comme date de dernière modification. 

La syntaxe générale de la fonction touch( ) est la suivante : 

I boolean touchCstring "noin_fichier"[,integer timestamp]) 

Le nom du fichier vient en premier paramètre, et le timestamp de la date de création en 
second. 

En écrivant, par exemple : 

if ( !f i 1 e_exi st s ( "monfich.txt" ) ) 
{ 

touche "monfich.txt" ,time( ) ) ; 
} 

vous créez le fichier monfich.txt s'il n'existe pas encore, avec pour date de dernière 
modification l'instant en cours donné par la fonction time( ). Le fichier est vide mais est 
disponible en écriture, comme vous le verrez à la section suivante. 

La fonction fi 1 e_exi sts ( ) utilisée dans cet exemple retourne TRUE si le fichier existe déjà 
et FALSE dans le cas contraire. 

Ouverture du fichier 

Avant de réaliser des opérations de lecture ou d'écriture sur un fichier, vous devez 
l'ouvrir explicitement. Vous disposez pour cela de la fonction fopenO, qui nécessite 
plusieurs paramètres. Le choix de ces paramètres conditionne le mode d'accès au fichier 
et ce que vous allez pouvoir en faire, à savoir le lire uniquement, y écrire uniquement ou 
le lire et y écrire dans le même script. 

La syntaxe de la fonction fopen( ) est la suivante : 

I resource fopen(string $nom, string mode, [boolean path]) 
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La section suivante examine le rôle de ces différents paramètres. 
Paramètres de la fonction fopen() 

Le premier paramètre de la fonction fopenO est une chaîne de caractères indiquant le 
nom du fichier que vous souhaitez utiliser. Ce nom peut être sous une forme réduite 
(le nom du fichier seul) ou développée (le nom du fichier et son chemin d'accès 
complet). 

L'adresse du fichier peut être un chemin relatif du type : 

I ". ./. ./repertoi re/monfichier.txt" 

ou une URL absolue de la forme : 

I "http://www.monsite.net/repertoire/monfichier.txt" 

ou : 

I "ftp://ftp.monsite.com/monfichier.txt" . 

Si vous n'indiquez que le nom du fichier, ce dernier doit se trouver dans le même réper- 
toire que le script qui l'ouvre. 

Le deuxième paramètre détermine le mode d'accès au fichier. Ce mode est codé dans une 
chaîne et peut prendre les valeurs suivantes : 

• " r" : le fichier est ouvert en lecture seule, et la lecture commence au début du fichier. 

• "r+" : le fichier est ouvert en lecture et en écriture, et ces opérations commencent au 
début du fichier 

• "w" : le fichier est ouvert en écriture seule, et l'écriture commence au début du fichier. 

• "w+" : le fichier est ouvert en lecture et en écriture, et ces opérations commencent au 
début du fichier 



Effacement systématique 

Pour les modes "w" et "w+", si le fichier n'existe pas ii est créé automatiquement. S'il existe, son contenu 
antérieur est effacé. Il faut donc prendre des précautions avant d'utiliser ce mode d'accès. 



• "a" : le fichier est ouvert en écriture seule, et les données sont écrites en fin de fichier, 
à la suite de celles qui existent déjà ou au début s'il est vide. Si le fichier n'existe pas, 
il est créé. 

• "a+" : le fichier est ouvert en lecture et en écriture, et les données sont écrites en fin de 
fichier, à la suite de celles qui existent déjà. La lecture s'effectue à partir du début 
du fichier. Si le fichier n'existe pas, il est créé. 

Le troisième paramètre est un booléen. S'il vaut TRUE (ou 1), la recherche du fichier est 
étendue à tous les sous-répertoires du chemin indiqué dans le premier paramètre. S'il 
vaut FALSE, la recherche est limitée à l'emplacement indiqué. 
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Identifiant de fichier 

Depuis PHP 4, la fonction fopenC ) retourne un identifiant de fichier de type resource (il 
était de type integer dans PHP 3), qui doit être utilisé comme premier paramètre de la 
plupart des fonctions de manipulation des fichiers. Vous devez donc impérativement 
récupérer cette valeur dans une variable pour pouvoir l'utiliser dans les autres opérations 
d'accès au même fichier. Nous noterons systématiquement cette variable $icl_file. 

En affichant la valeur de cet identifiant, vous constatez qu'il est de la forme Resource 
i d#n, dans laquelle n est un entier incrémenté de 1 à chaque ouverture de fichier par le 
même script (la première valeur est toujours 1). Cet affichage n' a pour but que de satisfaire 
une curiosité car il ne sera jamais effectué dans un script. En cas d'échec de l'ouverture 
du fichier, la fonction retourne la valeur FALSE, ce qui peut permettre l'affichage d'un 
message d'erreur. 

Pour ouvrir en écriture seule un fichier existant dans le même dossier que le script en 
cours et récupérer son identifiant, vous écrivez, par exemple : 

|$id_file = fopenC "monfichier.txt" , "a" ) ; 
if( !$id_file) echo "Erreur d'accès au fichier"; 

Rien n'empêche d'ouvrir plusieurs fichiers simultanément et de manipuler ainsi plusieurs 
identifiants. Vous pouvez ensuite fermer un fichier sans fermer les autres. 

Fichier temporaire 

Vous pouvez aussi créer un fichier temporaire sur le serveur à l'aide de la fonction : 
I resource tmpfi 1 e( ) 

qui retourne également un identifiant de fichier. 

Ce fichier est utilisé pour stocker des informations qui ne seront conservées que pendant 
la durée de la session ouverte par un client ou jusqu'à ce que le fichier soit explicitement 
fermé au moyen de la fonction f cl ose( ). 

Fermeture du fichier 

Après avoir ouvert un fichier pour y effectuer des opérations de lecture ou d'écriture, il 
vous faut impérativement le fermer pour éviter tous les problèmes qui pourraient résulter 
d'une tentative d'ouverture du même fichier de la part d'un autre script ou du même 
script ouvert par une autre connexion. 

L'opération de fermeture est réalisée à l'aide de la fonction suivante : 
I boolean fclose($id_file) 

Cette fonction prend comme unique paramètre l'identifiant de fichier $id_file retourné 
par la fonction fopenC ). Elle retourne la valeur booléenne TRUE si l'opération de fermeture 
s'est bien effectuée, et FALSE dans le cas contraire. Vous pouvez donc réaliser un test 
systématique pour vérifier le bon déroulement de l'opération de fermeture. 
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Verrouillage des fichiers 

Quand un script utilise une base de données telle que MySQL pour y stocker des infor- 
mations, l'ampleur du trafic sur le site n'a pas une importance primordiale. Plusieurs 
utilisateurs peuvent accéder en même temps à la même table et y effectuer des opérations 
de lecture ou d'écriture. MySQL se charge de gérer les priorités des opérations entre 
les différentes connexions, évitant ainsi toute confusion. Il n'en va pas de même avec les 
fichiers, dont la structure est moins évoluée qu'une base de données. 

Si plusieurs utilisateurs accèdent au même fichier à partir du même script ou de deux 
scripts différents et y effectuent simultanément des opérations de lecture ou d'écriture, le 
fichier risque de devenir inutilisable pour chacun d'eux. 

Afin d'éviter la corruption des fichiers qui pourrait en résulter, il est essentiel, avant 
d'écrire ou de lire un fichier, que les scripts qui y accèdent définissent une priorité 
d'accès au premier script effectuant une opération sur le fichier. Cela empêche les autres 
d'y accéder et d'y faire des modifications tant que le fichier n'est pas fermé. 

Vous disposez pour cela de la fonction flock( ), qui donne la possibilité de verrouiller le 
fichier en en bloquant partiellement ou complètement l'accès pour d'autres utilisateurs 
pendant qu'un script y accède, jusqu'à ce qu'il soit fermé et donc libéré pour d'autres 
accès concurrents. 

La syntaxe de la fonction f 1 ock( ) est la suivante : 
I boolean fl ock( resource $id_file,int N) 

Le premier paramètre est encore l'indispensable identificateur de fichier retourné par la 
fonction fopenO. Le second est une constante entière nommée qui définit le mode de 
verrouillage du fichier : 

• flock($id_file,LOCK_SH) bloque l'écriture dans le fichier mais laisse le libre accès en 
lecture à tous les utilisateurs. La constante LOCK_SH a la valeur 1. 

• flock($id_fi le, LOCK_EX) bloque l'écriture et la lecture du fichier par un autre script. Le 
script en cours a donc l'exclusivité. Une tentative d'accès simultané retourne la valeur 
FALSE. La constante LOCK_EX a la valeur 2. 

• f 1 ock( $i d_f i 1 e , LOCK_UN ) libère le verrou installé précédemment. Vous ne devez surtout 
pas oublier d'effectuer cette action après les opérations réalisées sur le fichier, faute de 
quoi le blocage subsiste. La constante LOCKJN a la valeur 3. 

Vous pouvez employer les noms des constantes ou les valeurs entières 1, 2 ou 3. Si 
plusieurs scripts différents permettent d'accéder à un même fichier, ils doivent tous défi- 
nir des verrous sur ce fichier. Il faut donc utiliser systématiquement cette fonction dans 
tous les scripts. 

Si le verrouillage des fichiers présente l'avantage de la sécurité, il a aussi l'inconvénient 
d'interdire les accès simultanés et de ralentir l'accès aux fichiers pour le stockage. 
L'utilisation des fichiers est donc limitée aux sites qui ont un trafic limité ou aux opéra- 
tions de maintenance ou de sauvegarde. 
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Compte tenu des fonctions que vous venez de voir, le schéma général d'utilisation d'un 
fichier conduit à écrire systématiquement le code suivant : 

$id_file = fopen("monfichier.txt","mode"); 
flock($id_file.LOCK_SH ou LOCK_EX); 
//ou encore 

//flock($id_file.l ou 2); 

//opérations de lecture et/ou d'écriture 

flock($id_file(LOCK_UN): 

//ou encore 

//flock($id_f11e.3); 

fclose($id_file) 

Vous devrez aussi ajouter par la suite les fonctions de lecture et d'écriture des fichiers. 

Écriture dans un fichier 

Une fois qu'un fichier est ouvert avec fopenO, vous pouvez procéder aux opérations 
d'écriture ou de lecture de son contenu. 

Pour écrire dans un fichier avec l'un des modes définis dans la fonction fopenO, vous 
avez le choix entre plusieurs méthodes et donc entre plusieurs fonctions spécialisées de 
PHP. Le choix de ces fonctions s'effectue en fonction du type d'information à écrire. 

Conserver une information 

Les fonctions fwrite( ) et fputs( ), alias l'une de l'autre, ont la syntaxe suivante : 

Iinteger fwrite(resource $id_file.string "chaîne" [,int N]) 
integer fputs( resource $id_file, string "chaîne" [,int N]) 

Elles écrivent toutes deux le texte contenu dans "chai ne" dans le fichier identifié par la 
variable $id_file. Lorsque le paramètre N est précisé, comme ici, seuls les N premiers 
caractères de la chaîne sont écrits dans le fichier. 

Votre premier exemple d'utilisation des fichiers est un compteur de visites très simple 
enregistrant le nombre cumulé de visites dans un fichier nommé compteur.txt. A chaque 
connexion, le script vérifie si ce fichier existe déjà (repère O). 

S'il existe, le script l'ouvre en lecture (repère ©) et le verrouille en écriture (repère 0). 
Il lit ensuite dans la variable $nb la dernière valeur enregistrée à l'aide de la fonction 
freadO (repère O, que nous définirons plus avant dans les sections suivantes) l'incré- 
mente d'une unité (repère 0) et ferme le fichier (repère ©). Vous ouvrez ensuite le 
fichier en écriture avec le mode "w", ce qui efface l'ancienne valeur (repère ©), et y écri- 
vez la nouvelle valeur de $n (repère ©). Vous libérez ensuite le verrou et fermez le fichier 
(repères Q et ®)- 

Si le fichier n'existe pas, il est créé et ouvert en écriture (repère ®). Vous y enregistrez la 
valeur 1 ou davantage, si vous voulez faire croire que le site est très prisé. Ici $nb est 
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défini d'emblée à 10 000 visiteurs (repère ®). Vous réalisez ensuite les mêmes opéra- 
tions d'écriture (repère ©) et de fermeture du fichier (repère ©). La dernière instruction, 
echo, affiche la valeur en cours du compteur dans un tableau (repère ®). 

'-^ Exemple 11.1. Compteur de visites à l'aide d'un fichier 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/tr/html4/strict.dtd"> 

<html> 

<head> 

<meta http-equiv="content-type" content= 

"text/html : charset=iso-8859-l"> 

<title>titre</title> 

</head> 

<body> 

<?php 

if (f i le_exi s ts(" compteur.txt")) <— O 
{ 

1 f ($id_f 1 1 e=fopen( "compteur .txt" , "r" ) ) <— © 

{ 

flock($id_f11e.l); <-© 

$nb=fread($1d_file,10): <-© 

$nb++; <— 0 

fclose($id_file): <-© 

$id_f i 1 e=fopen( "compteur.txt" , "w" ) ; <—Q 

flock($id_file.l); 

fwrite($id_file,$nb) : <— © 

flock($id_file,3); <-0 

fclose($id_file); <-® 

} 

else {echo «fichier introuvable"; } 

} 

el se 
{ 

$nb=10000; <-© 

$id_f i 1 e=fopen( "compteur. txt" , "w" ) ; <— ® 
fwrite($id_file.$nb): <-© 
fclose($id_file): ^© 

} 

echo "<table border=\"l\" style=\"font-size:2em;\"> <tr> 

^<td style=\"background-color:blue;color:white;\">Voici déjà </td> 

<td style=\"font-size:1.2eni;background-color:white;\"> $nb </td> 

<td style=\"background-color:red;\"> visites sur le site </td></tr></tabl e> " ; <— © 

?> 

</body> 
</html> 

La figure 11-1 présente le résultat de cet exemple, avec une petite exagération sur le 
nombre de visiteurs initial. 
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Figure 11-1 

Un compteur de visites 

Formatage des données 

Vous allez maintenant saisir le nom et le prénom des visiteurs et ajouter dans le fichier la 
date de la saisie grâce à la fonction time( ) (voir le chapitre 8). 

Pour que les données issues du formulaire soient traitées par le fichier lui-même, vous 
devez indiquer le nom du fichier dans l'attribut action de l'élément <forin> ou, mieux 
encore, utiliser la variable $PHP_SELF (voir le chapitre 6). 

Pour faciliter la lecture et la récupération des données écrites dans le fichier, faites suivre 
chaque donnée d'un retour à la ligne créé par la chaîne "\n", que vous concaténez 
avec chaque donnée. 

Votre script précédent ne faisait que créer un fichier devant contenir une unique valeur, 
différente pour chaque connexion mais toujours unique. La lecture ne posait donc pas de 
problème. Si vous voulez enregistrer le nom et le prénom d'un visiteur ayant rempli un 
formulaire ainsi que la date de la connexion à l'aide de la fonction time( ), il vous faut 
un moyen de séparer les données sous forme de paquets. Ces paquets occuperont chacun 
une ligne du fichier, ce qui facilitera la lecture d'un paquet à la fois. Chaque ligne du 
fichier texte sera un enregistrement correspondant à un seul visiteur. 

Vous pouvez formater les données en les séparant théoriquement par n'importe quel 
caractère. En pratique, il y a lieu de choisir un caractère qui ne risque pas de faire partie 
d'une donnée entrée par l'utilisateur, par exemple un point-virgule que l'on ne devrait 
pas rencontrer dans un nom ou un prénom. Par sécurité, vous pourriez envisager d'effec- 
tuer un validation des données avant de les enregistrer à l'aide d'une expression régulière 
(voir le chapitre 4) pour éliminer celles qui ne sont pas conformes à un modèle stricte- 
ment alphabétique. A la fin de chaque enregistrement, vous ajoutez le caractère de retour 
à la ligne "\n", qui permet de n'avoir qu'un seul groupe de données par ligne du fichier. 

Ce formatage permet de surcroît une lecture plus facile du fichier en permettant la lecture 
de données de longueur inégale. 

La fonction d'écriture suivante : 

I fwrite($id_file,$noin.";". $prenom . ";" . $date . "\n" ) 
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écrit les chaînes de caractères contenues dans les variables $nom, $prenom et $date asso- 
ciées à un visiteur en les séparant par la chaîne " ; " et en terminant chaque enregistrement 
par un saut de ligne "\n". La structure du fichier texte correspondant est conforme à celle 
illustrée à la figure 11-2. Vous verrez tout l'intérêt de ce formatage des données en utili- 
sant la fonction de lecture particulière fgetcsv( ). 

L'exemple 11-2 ci-après utilise cette technique pour enregistrer le nom et le prénom d'un 
visiteur après soumission d'un formulaire de saisie. La date du jour fournie par la fonc- 
tion timeO, qui retourne le timestamp correspondant à l'instant de l'enregistrement, est 
enregistrée en même temps que la valeur des variables précédentes. 

Le script PHP de traitement des données étant incorporé au même fichier que le code 
HTML, l'attribut action de l'élément <form> est désigné par la variable $_SERVER ["PHP_ 
SELF"]. 

L'instruction du repère Q ■ 

I if(isset($_POST['nom']) && isset($_POST['prenom'])) 

vérifie la présence des variables contenant le nom et le prénom. Si le visiteur ne complète 
pas toutes les zones de texte, un message lui rappelle les instructions (repère ©). 

L'instruction du repère 0 : 

I i f ( $ i d_f i 1 e=f open ( "noms . txt " , " a " ) ) 

vérifie ensuite si l'ouverture du fichier a réussi. Dans le cas contraire, un message 
d'erreur s'affiche. 

Le bloc de code suivant : 

flocl<($icl_file,2): 

fwri te($id_f ile.Sprenoiïi. " ; " . $nom. " ; " .$date. "\n" ) ; 

flock($id_file.3): 

fclose($id_file) ; 

réalise successivement le verrouillage, l'écriture des données formatées, le déver- 
rouillage puis la fermeture du fichier (repères 0, 0, 0 et 0), comme dans l'exemple 
précédent (exemple 11-1). 

La figure 11-2 montre la structure du fichier texte noms. txt créé par le script telle que 
vous pouvez la visualiser dans le Bloc-notes de Windows. 



^ noms - Bbc-notes ^ 


1=1 




Fichier Edition Format Affichage ? 


Jean; Engels;lÛ797283020 
JaniGeeTsen; 10797283630 
Lucie; Feire;lû79738493û 
Macki n; Tosche; 1080164 65 70 


Vil 



Figure 11-2 

Structure du fichier texte formaté visualisée dans le Bloc-notes de Windows 
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'■^ Exemple 11-2. Saisie et enregistrement à partir d'un formulaire 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtmr' xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=i so-8859-1" /> 

<title>Les fichiers PHP </title> 

</head> 

<body style="background-color: #ffccOO;"> 

<form action="<?= $_SERVER[ ' PHP_SELF' ] ?>" method="post" > 

<fieldset> 

<legend><b>Enregistrez vos informations personnelles </b></legend> 

<p><b> Votre nom  &nbsp:   </b> 

<input type="text" name="nom" > <br /> 

<b> Votre prénom </b> 

<inpLit type="text" naiïie="prenom"> <br /> 

<input type="submit" val ue="Enregi strer"> 

<inpLit type="reset" val ue="Ef facer"></p> 

</fieldset> 

</form> 

<?php 

if(isset($_POST['nom']) && isset($_POST[ 'prénom' ])) <-0 
{ 

$nom=$_POST['nom']: 
$prenom=$_POST[ 'prénom' ] ; 

echo "<h2> Merci $prenom $nom de votre visite </h2> "; 
$date=time( ) ; 

i f ( $i d_f i 1 e=f open ( "noms . txt " , "a " ) ) <— © 
( 

flock($id_file.2); <-© 

fwrite($id_f i 1 e,$prenom. " ; " .$nom. " ; " . $date. "\n" ) ; <— 0 
flock($id_file,3); <-0 
fclose($id_file) : 

] 

else { echo "Fichier inaccessible";} 

} 

else{ echo "<h2>Complétez le formulaire puis cliquez sur 'Envoi' ! </h2> ":)<—© 
?> 

</body> 
</html> 
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Figure 11-3 

Page de saisie d'informations 



Lecture de fichiers 

Avant de lire le contenu d'un fichier, il faut généralement l'ouvrir. Comme vous l'avez vu, 
cela s'effectue à l'aide de la fonction fopenO. Pour effectuer la lecture elle-même, vous 
avez le choix entre plusieurs méthodes, chacune étant réalisable grâce à une fonction 
PHP spécialisée. Ces fonctions sont fgetsO, freadO, fseekO, fgetcvsO, readfileO, 
f i 1 e( ) et passthru( ). 

Les sections suivantes examinent les particularités respectives et le domaine d'applica- 
tion de chacune d'elles. Il vous appartient de choisir celle qui convient le mieux à vos 
besoins. 



Lire une ligne à la fois 

La fonction fgets( ) a pour syntaxe : 

I string fgets( resource $id_file,integer nombre_octets) 

Cette fonction lit le fichier depuis son début et retourne une chaîne de caractères d'une 
longueur maximale égale au paramètre nombre_octets. La lecture s'arrête quand ce 
nombre d'octets lu est atteint ou avant qu'il soit atteint, si le caractère "\n" est rencontré 
dans le fichier. 

Le code de l'exemple 11-3 effectue, à l'aide de la fonction fgets( ), la lecture du fichier 
noms . txt créé à l'exemple 1 1-2 et récupère les données de deux manières différentes. 

La première partie ouvre le fichier en lecture seule (repère Q) puis lit une ligne du fichier 
à la fois (repère 0), affiche chaque ligne dans une cellule de tableau XHTML (repère 0) 
et ferme le fichier (repère Q). 
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La seconde lecture, qui permet de récupérer chaque donnée individuellement, effectue 
les mêmes opérations et profite du formatage des données réalisé lors de l'écriture à 
l'aide du séparateur " ; " afin d'isoler chacune des données d'une ligne à l'aide de la fonc- 
tion explodeO. Cette dernière scinde la chaîne et crée le tableau $tab contenant chacun 
des mots de la chaîne (repère 0). 

Vous obtenez le prénom dans l'élément $tab[0], le nom dans $tab[l] et le timestamp dans 
$tab[2]. Vous pouvez dès lors afficher chacune des données dans une cellule particulière 
de tableau HTML et exploiter la valeur du timestamp pour afficher la date de connexion 
en clair à l'aide de la fonction date( ) (repère ©). Vous obtenez un affichage tel que celui 
de la figure 11-4. 

f*' Exemple 11-3. Lecture de fichier avec la fonction fgetsQ 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html : charset=i so-8859-1" /> 

<title>Lecture de fichiers avec fgetsO </title> 

</head> 

<body> 

<?php 

$fi 1 e="noms .txt" ; 

//Première lecture 
$id_file=fopen($file,"r");// <-© 
$i=l: 

echo "<h3>Lecture du fichier \"$file\" ligne par ligne<br /> 
^Affichage brut de chaque ligne</h3> "; 
echo "<table border=\"l\"> \n <tbody> \n"; 
while($ligne=fgets($id_file.lOO) )// <-© 
{ 

echo "<tr><td>Ligne numéro $i </td> <td><b>$ligne </b></td> </tr>"://<-© 

$i++; 

} 

fclose($id_file): <-© 
echo "</tbody></table> "; 
//Deuxième lecture 
$id_file=fopen($file,"r") ; 
$i=l: 

echo "<h3>Lecture du fichier \"$file\" ligne par ligne<br /> 
^Récupération de chaque donnée </h3> "; 
echo "<table border=\"l\"> <tbody>"; 

echo "<tr><th>Numéro </th> <th>prenom</th> <th>nom</th> <th>date</th></tr>" ; 

while($ligne=fgets($id_file,100) ) 

{ 

$tab=explDde ( " ; " ,$1 igne) ; <— © 

$jour= date("j/n/Y H:i :s" ,$tab[2] ) ; <-© 

echo "<tr><td>$i</td> <th>$tab[0]</th> <th>$tab[l]</th> <th>$jour</th> </tr>": 
$i++: 
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} 

fclose($id_file) ; 

echo "</tbocly></table> "; 

?> 

</body> 
</html> 



3 hHp://127.0.0.1/php5/C1inchiers/fichiers3.php -Microsoft Interne» E... 



Fichier Edition Affichage Favoris Outils ? 

Q Précédente - _J ^îi f<*à»reher Favoris ^ Média 

Adresse [i^http:;/l27.0.0.1/phpS/Cllflchler8/flcKert3.ply ^iH'^ 

y\ I 

Lecture du ficliier "noins.tvt" ligne par ligne 
Ailïcliage brut de cliaque ligne 

Ligni: numéro 1 Jeaii;Engels; 1079728302 
Ligne numéro 2 Jan;Geelsen;1079728363 
Ligne numéro 3 Lucie;Feire; 1079738493 

Lecture du fichier "noms.txt" ligne par ligne 
Récupération de chaque donnée 



p^timéro 


prénom 


nom ' date 


F 


Jean 


Engels 19/3/2004 21:31^ 




Jan 


Geelsen 19/3/2004 21:32:43 




Lucie 


Feire 20/3/2004 00:21:33 



^ Terminé 9 Internet 

Figure 11-4 

Lecture des lignes brutes et des données 



Lire un nombre de caractères donné 

La fonction f read( ) a pour syntaxe : 

I string fread( resource $id_file,integer nb_octets) 

Cette fonction lit également le fichier depuis son début et retourne à chaque appel une 
chaîne de caractères contenant exactement le nombre de caractères précisé dans le 
second paramètre, sauf si la fin du fichier est atteinte ou si le caractère "\n" est rencontré. 
Son utilisation est donc adaptée à des fichiers dans lesquels vous avez préalablement 
enregistré des données de longueur fixe par paquets égaux. 

Pour illustrer l'usage de cette fonction, vous allez créer un script permettant d'implanter 
sur un site un système de vote enregistrant les choix des visiteurs effectués grâce à un 
formulaire de saisie. Chaque proposition de vote pour un footballeur est faite à l'aide 
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d'un bouton radio, et tous les boutons ont la même valeur pour l'attribut name. Cela oblige 
le visiteur à faire un choix unique, chaque clic sur un bouton désactivant le choix précé- 
dent. Le script de traitement des votes ne reçoit de la sorte qu'une seule variable, quel que 
soit le vote. 

La valeur associée à chaque choix est contenue dans l'attribut value de chaque bouton 
radio, et c'est elle que le script récupère pour la stocker dans le fichier. La lecture se 
faisant par paquet d'octets de longueur fixe, les chaînes contenues dans les attributs 
val ue doivent toutes avoir la même longueur. Vous raccourcissez donc les noms stockés 
pour obtenir cinq caractères, comme pour les valeurs "anel ka" et "gourcuff " (repères O 
et 0). 

Comme il n'est pas nécessaire d'enregistrer un texte expressif associé à chaque vote, 
vous auriez pu tout aussi bien associer à chaque choix des chaînes arbitraires du genre 
"aaa", "bbb", "ccc" ou encore plus simplement les chiffres "1", "2" et "3", ce que vous 
ferez dans le script suivant. 

Chaque vote est enregistré sur une ligne du fichier texte car vous ajoutez le caractère "\n" 
après chaque enregistrement. Lors de la lecture, il vous faut donc lire les données par 
groupe de 6 caractères et non par groupe de 5, comme vous auriez pu le penser après 
avoir enregistré des mots de 5 caractères. 

Le formulaire de saisie comporte deux boutons de type submi t, le premier pour voter et le 
second pour afficher les résultats en cours de l'ensemble des votes. 

Le script commence par tester sur quel bouton d'envoi l'utilisateur a cliqué (repère 0) 
puis, selon le cas, enregistre le vote dans le fichier texte "votes . txt" et affiche un message 
de remerciement (repère 0). Cette partie, destinée à l'enregistrement des données, 
n'apportant rien de nouveau par rapport aux exemples précédents, nous ne détaillons pas 
son fonctionnement. 

La partie Affichage des résultats lit tout le fichier puis affiche les résultats en nombre 
de voix et en pourcentage selon l'ordre croissant. Elle commence par initialiser le 
tableau Sresult des résultats des votes en mettant à 0 tous les scores (repère 0). 
Si le bouton Afficher est cliqué (repère 0), vous contrôlez l'ouverture du fichier 
votes . txt (repère 0). Une boucle whi 1 e lit ensuite les blocs de 6 caractères (repère 0) et 
incrémente chaque fois le score d'un des joueurs à l'aide d'une instruction switch 
(repère 0). 

Pour afficher des pourcentages, vous calculez le nombre total de votants (repère ®). 
Après avoir créé une copie du tableau Sresul t dans la variable $tri , vous la triez en ordre 
croissant en utilisant la fonction de tri arsort( ) (repère 0). 

Une boucle foreach permet alors l'affichage de l'ensemble des résultats (repère ®). 
f*" Exemple 11-4. Script de vote en ligne 

I<1D0CTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.cltd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
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<head> 

<meta http-equiv="content-type" content="text/htinl ; charset^i so-8859-1" /> 

<title>Sonclage en ligne : VOTEZ FOOT!</title> 

</head> 

<body style="background-color: #ffccOO;"> 

<form action="<?php echo $PHP_SELF ?>" method="post" > 

<fieldset> 

<1 egend><b>Votez pour votre joueur préféré! </b></legend> 

<P> 
<?php 

$joueurs=array( "anel k"=>"Anel ka" , "goure "=>"Gourcuff" , "riber"=>"Ribéry" ) ; 
?> 

Anelka<input type="radio" name="vote" val ue="anel k" /> <br /> <— O 
Gourcuff<input type="radio" nanie="vote" val ue="gourc" /> <br /> <— 0 
Ribéry<input type="radio" name="vote" value="riber" /> <br /> 
<input type="submit" val ue="Voter" /> 

<input type="submit" value="Afficher les résultats" name="affiche" /> 
</p> 

</fieldset> 
</form> 

//Enregi strement 
<?php 

if(isset($_POST["vote"])) <-© 
{ 

$vote=$_POST["vote"]: 

echo "<h2> Merci de votre vote pour " . $joueurs[$vote] ."</h2> " ; <— © 
if (fi 1 e_exists( "votes .txt" ) ) 

{ 

if ($id_file=fopen( "votes.txt" , "a") ) 
{ 

flock($id_file.2); 
fwrite($id_f i 1 ejvote. "\n" ) ; 
flock($id_file,3); 
fclose($id_file) ; 

} 

el se 

{ echo "Fichier inaccessible": 

} 

} 

el se 
{ 

$id_f il e=fopen( "votes .txt" , "w" ) ; 
fwrite($id_file,$vote. "\n" ) ; 
fclose($id_file) ; 

) 

} 

el se 

{ echo "<h2>Complétez le formulaire puis cliquez sur 'Voter' ! </h2> ";} 
//Affichage des résultats 
//Initialisation du tableau des résultats 
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$result=array("Anelka"=>0,"Gourcuff"=>0,"Ribéry"=>0) : <— 0 

//Affichage des résultats 
if(isset($_POST["affiche"])) <-© 
{ 

i f ( $i d_f i 1 e=f open ( " votes . txt " , " r " ) ) <— O 

{ 

while($ligne=fread($id_file,6) ) <— 0 

{ 

switch($ligne) <— Q 
{ 

case "anelk\n": 

$result["Anelka"]++: 

break; 

case "gourc\n": 

$result["Gourcuff"]++; 

break; 

case "riber\n": 

$result["Ribéry"]++: 

break; 

defaul t: 

break; 

} 

) 

fclose($id_file); 
) 

$total= ($result["Anelka"] + $resLilt["GoLircuff"]+$result["Ribéry"])/100; <— ® 

$tri=$result; 

arsort($tri); <— © 

echo "<div style=\"border-style:double\" >"; 
echo "<h3> Les résultats du vote </h3>": 
foreach($tri as $nom=>$score) <— ® 
{ 

echo "<h4>$i<sup>e</sup> : ", $nom," a $score voix soit ", 

^number_format($score/$total ,2) , "Z</h4>" ; 

) 

echo "</div>"; 

} 

?> 

<P> 

<a href="http: //val idator.w3.org/check?uri=referer"><img 
s rc="http: //www. w3.org/Icons/ val id-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 

</p> 
</body> 
</html> 

Le résultat de ce script illustré à la figure 11-5 présente le formulaire de saisie avec le 
résultat des votes. 
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Fjchîer Édition ^fichage Histofique Marque-pages Outils ? 




Sondage en ligiie:V... X | B [VaBd l Mariaip Validât- x | h^l^li//^»»»«»■■■hiels^^lhp x | 0 FFF ; Equipe de France.- X (» 



^ C /\ ^ { , , http://wvvw.funhtml.com/php5/Cll/fichiefs4.php "Ç^ ^ j iGl ' j équipe de france ^ 



~Votez pour votre joneur préféré! 



AneBca 
GourcnfiT 
Ribcr>- 



I Voter 1 1 Afficher les fésultats~| 



Complétez le formulaire puis cliquez sur 'Voter' ! 

Les résultats du vote 
1*^ : Aneika a 9 voix soit 45.00% 
2' : Ribén a 7 vode soit 35.00% 
î' : GonrcnS a 4 roix soit 20.00% 



Figure 11-5 

Page de vote en ligne et résultats 

Lire un caractère à la fois 

PHP propose une fonction pour lire un caractère à la fois dans le fichier texte. Cette 
possibilité n'a d'intérêt que si vous pouvez stocker les informations dans le fichier sous 
une forme codée avec des chiffres de 0 à 9 ou encore avec des lettres de A à Z. Cela 
permet d'étendre les possibilités à 26, voire le double si vous utilisez aussi les minus- 
cules de a à z. 

La fonction PHP à utiliser est : 
I string fgetc( resource $id_file) 

Elle utilise comme unique paramètre l'identifiant de fichier retourné par la fonction f open ( ) . 
Vous allez l'appliquer à votre script de vote précédent en modifiant le code du fichier 
XHTML pour attribuer comme valeur associée à chaque bouton radio un chiffre de 1 à 3. 

Remplacez pour cela les trois lignes de création des boutons par le code suivant : 



Tenminé 



Anelka<input type="radio" name="vote" value="l" /> <br /> 
Gourcuff<input type="radio" nanie="vote" value="2" /> <br /> 
Ribéry<input type=" radio" name="vote" value="3" /> 
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Chaque vote est enregistré dans le fichier votes 2 . txt par un nombre de 1 à 3 sans saut de 
ligne après chacun d'eux. Ce fichier a la structure d'une suite de nombres entiers non 
séparés par des espaces, comme l'illustre la figure 1 1-6. Si une telle structure est évidem- 
ment très difficile à lire pour un humain, la fonction fgetc( ) le fait très facilement à votre 
place. 



P votes2 - Bloc-notes 



Fichier Edition Fornnat Affichage ? 

iL1123123212323112322331111221122213321112123 



Figure 11-6 

Fichier de données votes2.txt visualisé dans le Bloc-notes de Windows 

La partie du script qui effectue la lecture des données ne diffère que par l'utilisation de la 
fonction fgetc( ). Cette partie devient donc : 

if ($icl_file=fopen ("votes2.txt" , "r") ) 
{ 

while($ligne=fgetc($id_file) ) 
{ 

switch($l igne) 
{ 

case "1": 

$result["Anelka "]++; 

break; 

case "2": 

$result["Gourcuff "]++; 

break; 

case "3": 

$result["Ribéry "]++; 

break; 

defaul t: 

break; 

) 

} 

} 

Cette technique vous permet de stocker davantage d'informations codées sous un volume 
réduit. 

Lecture d'une partie d'un fichier 

Chaque fichier possède un pointeur de lecture et d'écriture que vous pouvez positionner 
en un point précis du fichier. 
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Lors des opérations de lecture réalisées jusqu'à présent, le contenu du fichier est extrait à 
partir de son début car, par défaut, le pointeur est positionné au début du fichier si le para- 
mètre mode de la fonction fopen( ) vaut "r", "r+", "w" ou "w+", et en fin de fichier s'il vaut 
"a" ou "a+". 

Vous avez également la possibilité de faire débuter la lecture en n'importe quel point du 
fichier en appelant la fonction : 

I integer fseek( resource $id_file,integer noinbre_d' octets) 

Cette fonction utilise comme les autres l'identificateur de fichier $id_file et comme 
second paramètre la position donnée par un entier représentant le nombre d'octet par 
rapport au début, à partir de laquelle doit commencer la lecture. Elle ne renvoie pas une 
valeur du fichier et ne fait que positionner un pointeur en un point particulier. Elle doit 
bien sûr précéder l'appel de la fonction de lecture proprement dite. 

La fonction integer fseekC ) retourne la valeur booléenne TRUE si l'opération est réussie et 
la valeur -1 dans le cas contraire. Cela permet d'effectuer une vérification dans le script. 

Pour illustrer ce type de lecture, vous allez reprendre l'exemple précédent et éliminer les 
dix premiers votes en faisant débuter la lecture au onzième caractère du fichier, car 
chaque vote n'occupe plus qu'un seul caractère. Il est possible à tout moment de remettre 
le pointeur au début du fichier à l'aide de la fonction : 

I boolean rewind(resource $id_file) 

qui retourne FALSE en cas d'échec. 

Quand la lecture est en cours, la fonction suivante retourne la position du pointeur en 
nombre d'octets par rapport au début du fichier, qui permet de savoir quel est l'enregis- 
trement lu : 

I integer ftell ($id_file) 

Cette fonction retourne FALSE en cas d'erreur. 

En complément, la fonction : 

I integer filesize(string "noni_fichier") 

retourne le taille totale du fichier, ce qui vous permet de lire uniquement, par exemple, 
les vingt derniers votes enregistrés. 

Pour cela, il vous suffit d'insérer les lignes suivantes : 

IStai 1 1 e= f i 1 esize( "votes2.txt" ) ; 
fseek($id_file.$taille-20): 

avant le début de la boucle whi 1 e, qui effectue la lecture des données du fichier. 

Vous récupérez dans la variable $tai 1 1 e le nombre total d'octets du fichier puis positionnez 
le pointeur 20 octets avant la fin du fichier. Cela n'est possible que parce que chaque vote 
est enregistré sur un seul caractère. Vous avez donc toujours intérêt à coder les enregistre- 
ments sur un seul caractère quand vous proposez un éventail de choix limité aux visiteurs. 
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Lecture de données formatées 

Quand le fichier à lire contient des données sous forme de chaînes de caractères de 
longueur irrégulière, correspondant à des entrées diverses de la part des utilisateurs, les 
méthodes précédentes se révèlent difficiles à mettre en œuvre pour récupérer les données. 

Vous avez déjà réalisé l'écriture de données formatées en les séparant à l'aide d'un carac- 
tère particulier, en l'occurrence un point- virgule, dans le fichier noms.txt de l'exem- 
ple 11-2. Vous allez maintenant les lire d'une manière plus élégante grâce à la fonction : 

I array fgetcsvCresource $id_file, integer nombre_octets , string "séparateur") 

Cette fonction lit dans le fichier identifié par $icl_file au maximum le nombre de carac- 
tères précisé à l'aide du deuxième paramètre. A la différence des autres fonctions de 
lecture, elle retourne directement un tableau de chaînes de caractères et non une seule 
chaîne à chaque appel, comme si vous appliquiez la fonction explodeO à une chaîne 
comprenant un séparateur. 

Le premier élément de ce tableau est la chaîne comprise entre le début du fichier et 
l'apparition du caractère de séparation ou de la chaîne indiquée par le troisième paramètre. 
En règle générale, vous vous limiterez pour cette chaîne à un seul caractère, tel qu'il est 
utilisé dans l'écriture du fichier noms.txt. Il est théoriquement envisageable de séparer 
chaque donnée par la chaîne "stop", par exemple, ou n'importe quelle autre chaîne ne 
risquant pas de correspondre à une entrée réelle d'un visiteur. En pratique, tous les tests 
effectués avec un séparateur de plusieurs caractères provoquent des problèmes lors de la 
lecture. Vous vous limiterez donc à un seul caractère, en l'occurrence les deux-points " : ". 

Les éléments suivants du tableau de résultats sont les chaînes comprises entre deux 
occurrences du séparateur. La lecture de chaque ligne s'arrête, comme avec les autres 
fonctions, lors de l'apparition d'un saut de ligne "\n" dans le fichier. 

L'utilisation de la fonction fgetcsvO fournit la meilleure gestion des données. Vous la 
mettrez en pratique dans le script suivant, qui crée un livre d'or dans lequel chaque visiteur 
peut enregistrer son nom, ou son pseudonyme le plus souvent, son adresse e-mail, la date 
du moment précis de l'enregistrement fournie par la fonction timeO (repère O) et le 
texte de son commentaire. 

Les valeurs transmises par le formulaire sont contenues dans les variables $_POST [ ' nom ' ] , 
$_POST['mail '] et $_POST[ ' comment ' ]. Le script commence par vérifier que chacun des 
champs est complété puis enregistre ces données et la date en cours en les séparant par le 
caractère " : " et en finissant chaque ligne par le caractère "\n" (repère 0). Comme dans 
les scripts précédents, une vérification est faite lors du premier enregistrement pour créer 
le fichier 1 ivre.txt quand il n'existe pas (repère 0). 

La lecture est réalisée si l'utilisateur clique sur le bouton "Afficher les avis", ce qui est 
détecté par le contrôle de l'existence de la variable $_POST[ ' af f i che ' ] (repère 0). 

Après ouverture du fichier (repère 0), une boucle whi 1 e lit un maximum de 200 caractè- 
res par ligne à l'aide de l'instruction suivante (repère 0) : 

I while($tab=fgetcsv($icl_file,200,":")) 
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et enregistre les données dans le tableau $tab. L'affichage se fait sous forme de tableau 
XHTML, comme l'illustre la figure 11-7. Dans ce tableau, chaque adresse e-mail est conte- 
nue dans un lien mai 1 to : , ce qui permet à un visiteur de répondre à un autre (repère Q). 

'•^ Exemple 11-5. Livre d'or utilisant des données formatées 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtn)lll.dtcl"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 

<title>Le livre est d'or </title> 

</head> 

<body style="background-color: #ffccOO;"> 

<form action="<?php echo $PHP_SELF ?>" method="post" > 

<fieldset> 

<legend><b>Donnez votre avis sur PHP 5 ! </b></legend> 

<label>Nom : &nbsp ;</! abel Xi nput type="text'' name="nom" /> <br /> 

<label>Mail :  </label><inpLit type="text'' name="mail" /> <br /> 

<label>Vos commentaires sur le site</l abel Xbr /> 

<textarea name="comment" rows="4" col s="50">Ici </textarea> <br /> 

<input type="submit" val ue="Envoyer " name="envoi " /> 

<input type="submit" val Lie="Afficher les avis" name="aff i che" /> 

</fieldset> 

</form> 

<?php 

$date= timeO:// <-0 
//ENREGISTREMENT 
if(isset($_POST['envoi '])) 
{ 

if(isset($_POST['nom']) && isset($_POST['mail ']) && isset($_POST['comment'])) 

{ 

echo "<h2>",$_P0ST['nom']," merci de votre avis </h2> "; 

i f ( f i 1 e_exi s ts ( " 1 i v re . txt " ) ) 

{ 

if ($id_file=fopen("livre.txt","a")) 

{ 

flock($id_file,2); 

fwri te( $i d_f i 1 e, $_POST[' nom '].":".$_POST[' mail '].":".$date.":". 

^$_POST['comment']."\n"): ^0 
flock($id_file,3); 
fclose($id_file): 
} 

el se 

{ echo "fichier inaccessible"; 
} 

} 

else 
{ 

$id_f ile=fopen( "1 i vre.txt" , "w" ) ; <— 0 
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fwrite($id_file,$$_POST['nom'].":".$$_POST['niair].":".$date.":". 
^$$_POST[ 'comment ' ] ."\n"): 
fclose($icl_file) ; 
} 

} 

} 

//LECTURE DES DONNES 

i f ( i sset ( $_POST[ ' af f i che ' ] ) ) ^0 

{ 

i f ( $i d_f i 1 e=f open ("livre. txt " , " r " ) ) <— 0 
{ 

echo "<table border=\"2\"> <tbody>": 
$i=0; 

while($tab=fgetcsv($id_file,200,":") ) <-© 

{ 

$i++: 

echo "<tr> <td>n" $i : de: $tab[0] </td> <td> <a href=\"mailto:$tab[l]\" > 
^$tab[l] </a></td> <td>le: " ,date( "d/m/y" ,$tab[2] ) . " </td></tr>" ; <-© 
echo "<tr > <td colspan=\" 3 \">", stripslashes($tab[3]) ,"</td> </tr> 
) 

fclose($id_file); 
) 

echo "</tbody></table> 

} 

else{ echo "<h2>Donnez votre avis puis cliquez sur 'envoyer' ! </h2> ";} 
?> 

</body> 
</html> 

Lecture de la totalité d'un fichier 

Dans les cas où les fichiers contiennent des données utilisables dans une page Web à titre 
de contenu de grande longueur (articles, documentations, etc.), il est envisageable de 
créer des pages dynamiques, dont seule une partie du texte est adaptée à une circonstance 
particulière. Vous avez alors besoin de lire la totalité d'un fichier sans avoir à analyser 
son contenu, comme vous l'avez fait pour le script de votes, et à l'envoyer directement au 
navigateur, comme le ferait une instruction echo. 

La fonction à utiliser est : 

I integer readfile(string "nom_fichier" , [boolean path]) 

Cette fonction prend comme premier paramètre le nom du fichier. Le second paramètre 
est facultatif. S'il vaut TRUE, il indique que la recherche du fichier doit se faire dans 
le dossier courant et dans le dossier de niveau supérieur s'il n'est pas trouvé dans le 
premier ; s'il vaut FALSE, la recherche est limitée au dossier qui contient le script. 

La fonction retourne un entier indiquant le nombre total d'octets affichés. Contrairement à 
la plupart des fonctions de lecture, readf i 1 e( ) ne nécessite pas l'appel des fonctions fopen( ) 
et f cl ose( ) d'ouverture et de fermeture. Cette fonction est illustrée à l'exemple 11-6. 
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I Le livre est d'or - Mozilla Riëfoxl 



fichier Édition Affichage Historique Marque-pages Outils l 

- O ^ _ http://localhost'chapll/fichiers5.php 



Donnez votre ans snr PHP 5 ! 

Nom ; 
Mail : 

Vos conuuentaires snr le site 

Ici 




n° 1 : de: Ronald 



le:16'll'08 



C'est facile, pas cher et ça marche d'enfer! 



n° 2 : de: Pierre 



le: 18 11 08 



A\ ec la version PHP 5, les concurrents de PHP n'ont qu'à bien se tenir! 



n° 3 : de: Engels 



iensels'5 e%Tolles-Com 



le:21 11 08 



PHP 5 va apporter un renom eau certain sur le Web 



Terminé 



Figure 11-7 

Page du livre d'or avec l'ajfichage des avis 



Vous disposez d'une autre fonction, au comportement assez proche de readfileO 
puisqu'elle ne nécessite pas l'ouverture explicite du fichier. Il s'agit de la fonction f i 1 e( ), 
qui retourne la totalité du contenu du fichier dans un tableau indicé dont chaque élément 
est constitué d'une seule ligne du fichier. Sa syntaxe est la suivante : 

I array fileCstring "noni_fichier") 

II suffit d'utiliser une boucle for ou foreach pour afficher chacune des lignes du tableau. 
Vous retrouvez donc des similitudes d'emploi entre cette fonction et la fonction f getcsvC ) 
utilisée à l'exemple 11-5, à la différence près que chaque élément du tableau est ici une 
ligne entière du fichier. Comme vous y aviez enregistré chaque donnée fournie par les 
visiteurs en utilisant comme séparateur le caractère dans le fichier livre.txt vous 
pouvez récupérer individuellement chaque donnée en « éclatant » la chaîne lue pour 
chaque ligne à l'aide de la fonction expl ode( ) (voir le chapitre 5). Cette fonction crée un 
tableau à quatre éléments à partir de ces chaînes qui comportent quatre mots (le nom, 
l'adresse e-mail, la date et le commentaire), séparés par des caractères " : ". 

Pour ne pas utiliser une trop grande quantité de mémoire, vous ne créez pas autant de 
variables qu'il y a de données totale mais réutilisez la même après chaque affichage. 
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En utilisant la fonction f i 1 e( ), la partie lecture des données de l'exemple 11-5 devient : 

if(isset($_POST["affiche"])) 
{ 

echo "<table border=\"2\"> <tbody>"; 
$i=0; 

//$tab contient toutes les lignes du fichier 

$tab=file("livre.txt"): 

//lecture de $tab 

for($i=0;$i<count($tab);$i++) 

{ 

$ligne= explode (":",$tab[$i]); 

echo "<tr> <td>de: $ligne[0] </td> <td> <a href=\"mai 1 to: $1 igne[l]\" > 
'•SligneEl] </a></td> <td>le: " .date( "d/m/y" ,$1 igne[2] ) . " </td></tr>": 
echo "<tr > <td colspan=\" 3 \">", stripslashes($ligne[3]) ,"</td> </tr> "; 

) 

echo "</tbody></table> "; 

} 

Le résultat de la lecture est exactement celui que vous avez obtenu avec la fonction 
fgetcsv( ), comme vous pouvez le constater à la figure 11-7. 

Une dernière fonction permet la lecture d'un fichier dans son intégralité. Il s'agit de la 
fonction : 

I fpassthru($id_file) 

qui, contrairement aux deux précédentes, nécessite l'emploi de fopenO pour ouvrir le 
fichier mais pas de f cl ose( ) pour le fermer. La fonction ferme automatiquement le fichier, 
ce qui implique que l'identifiant de fichier obtenu avec fopen( ) est ensuite inutilisable. 

Cette fonction n'est pas adaptée à toutes les situations. Comme freadO, elle envoie la 
totalité du contenu du fichier directement vers le navigateur. L'exemple 11-6 donne une 
illustration de ces fonctions pour afficher l'intégralité d'articles documentaires sur des 
sujets divers. A chaque sujet correspond un bouton "Submit", qui provoque l'affichage de 
tout article correspondant sous trois formes différentes. 

L'exemple 11-6 propose la lecture d'articles sur des sujets intéressant la conception Web. 

II est constitué d'un formulaire, dans lequel quatre boutons de type Submit permettent le 
choix de l'article affiché. Tous ces boutons ont le même nom, de façon qu'une seule 
valeur soit transmise au script procédant à l'affichage (repères 0> © st ©). Le script 
récupère le choix dans la variable $sujet (repère 0), puis l'article demandé est affiché 
successivement à l'aide des fonctions readfileO (repère©), fpassthruO (repère©) et 
file( ) (repère 0). 



Les fonctions freadQ et fpassthruQ 

À la figure 11-8, les fonctions f read( ) et f passthruC ) affichent le contenu du ficliier texte directement sur 
la sortie standard, sans tenir compte des retours à la ligne ni des espaces présents dans le ficiiier texte. Cela 
crée une présentation brute du texte alors que la fonction fi 1 e 0 qui récupère le texte ligne par ligne respecte 
tous les sauts de ligne tels qu'ils figurent dans le fichier d'origine, ce qui est beaucoup plus présentable. 
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<^ Exemple 11-6. Utilisation des fonctions readfileO, fpassthruQ et file() pour 
l'affichage d'articles 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" 

"http://www.w3.org/TR/html4/strict.dtd"> 

<html> 

<head> 

<meta http-equiv="content-type" content^ 
"text/html : charset=iso-8859-l"> 
<title>Choix d'articles </title> 
</head> 

<body style="background-color: #ffccOO;"> 

<form action="<?php echo $_SERVER[ ' PHP_SELF' ] ?>" method="post" > 
<fieldset> 

<legend><b>Choisissez votre sujet! </b></legend> 

<input type="subinit" name="sujet" val ue="htinl " /> <— © 

<input type="submit" name="sujet" value="javascript" /> <— 0 

<input type="subinit" name="sujet" value="php" /> <— 0 

<input type="submit" name="sujet" value="asp" /> <— 0 
</f1eldset> 
</forin> 



<?php 

//AFFICHAGE 

if(1sset($_P0ST['sujet'])) 
{ 

$sujet=$_POST['sujet']: <— 0 

echo "<h2>Voici l'article sur " .strtoupper($sujet) ,"</h2> "; 
//Lecture du fichier avec readfileO 

echo "<div style=\" background-color:#FFCCFF ; border-width:3px ; 

*border-style:groove; \" >"; 

echo " <h4>LECTURE avec readf i 1 e( )</h4>" ; 

readfile($sujet.".txt".TRUE) : <— © 

echo "</div>"; 

//Lecture du fichier avec fpassthruO 

echo "<div style=\" background-color:#FFAACC : border-width:3px ; 

*border-style:groove; \" >"; 

echo " <h4>LECTURE avec fpassthru( )</h4>" ; 

$id_f i 1 e=fopen($sujet . " .txt" , "r" ) ; 

fpassthru($id_fi1e) : 

echo "</div>"; 

//Lecture du fichier avec fileO 
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echo "<cliv style=\" background-color:#OOAAFF ; border-width:3px ; 

^border-style:groove; \" >"; 

echo " <h4>LECTURE avec file()</h4>": 

$tab = file($sujet.".txtM): <-© 

for($i=0;$i< count($tab); $i++) 

{ 

echo $tab[$i],"<br>": 

) 

echo "</div>"; 

} 

?> 

</body> 
</html> 



'3 Choix d'articles - Microsoft Internet Explorer 



Fichier Etttion Affichage Fivaa Outib ? 

Qprétckterte • ' @ [w] ^ ^Red«rcher ^Favoris ^ Média 

Adresse [^g http;//127.0.0.I/ph(l5/CllM«r»/fichlerj6.|*p 



Choisissez votre sujet! 
I himl 1 1 lavascripl | |php| |asp| 

Voici l'article sur HTML 



LECTURE avec readnieQ 

Le HTML Langage de balisage issu du SGML H comprend de nombreux éléments . Les éléments ayant 
un contenu ont une balise d'ouverture et une balise de fenneture. 



LECTURE avec fpassdunO 



Le HTML Langage de balisage issu du SGML H comprend de nombreux iilbnents Les éléments ayant 
un contenu ont une balise d'ouverture et une balise de fermeture. 

LECTimE avec filei 
Le HTML 

Langage de balisage issu du SGML 
n con?>rend de nombreux éléments . 

Les éléments ayant un contenu ont une balise d'ouverture et une balise de fermeture. 





4^ Terminé 



# Internet 



Figure 11-8 

Lecture d'articles entiers à l'aide des fonctions fread(), fpassthru() et file(). 
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Modifications de fichiers 

Il est possible d'intervenir sur les fichiers présents sur le serveur en effectuant des copies, 
en les renommant ou en les supprimant. 



Copier un fichier 

Il est possible d'effectuer une sauvegarde régulière de l'état d'un fichier à un moment 
donné en créant une copie sous un autre nom ou avec une extension différente afin de 
récupérer l'ensemble des données en cas de problème ayant atteint l'intégrité du fichier. 

Cette opération se réalise à l'aide de la fonction copy ( ), dont la syntaxe est la suivante : 

^ boolean copy(string "nom_fichier" .string "nom_copie") 

Cette fonction retourne la valeur booléenne TRUE si la copie est réalisée et FALSE en cas de 
problème d'écriture. 

Dans le code suivant, vous réalisez une copie du fichier votes.txt sous le nom 
votes. txt.bak (mais vous pourriez aussi bien le faire sous un nom quelconque) si le 
script est exécuté chaque jour à neuf heures du matin : 

<?php 

$date= getdateC ) ; 

if($date["hours"]==9 && $date["minutes"]==0) 
{ 

$result= (copyCvotes.txt", "votes. bak"))? "Copie réalisée": "Erreur de copie" ; 
echo $result; 

} 

?> 

Cette partie de code pourrait être ajoutée au script de vote pour effectuer la sauvegarde 
journalière ou constituer un script indépendant. 

Si le site a un trafic important, vous pouvez remplacer la condition de l'instruction i f par 
l'expression : 

I if($date["hours"]==9 && $date["niinutes"]==0 && $date["seconds"]==0) 

De la sorte, la sauvegarde n'a pas lieu à chaque connexion pendant tout la minute concer- 
née mais seulement pendant une seconde. Evidemment, si le site reçoit en moyenne plus 
d'une connexion par seconde (soit 86 400 par jour !), il faut faire appel à la fonction 
mi crotime( ) pour ne réaliser qu'une seule sauvegarde à une microseconde précise. 



Renommer un fichier 

Dans le même ordre d'idée que la fonction copy ( ), la fonction rename( ) permet de chan- 
ger le nom d'un fichier existant. Comme avec l'opération Renommer de l'Explorateur 
Windows, le fichier originel n'existe plus sous son nom initial, à la différence de la fonc- 
tion précédente. Si ce nom est utilisé dans le code d'un script, il faut bien réfléchir avant 
d'y avoir recours, car il faut en modifier toutes les occurrences. 
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Lors de l'appel de renameC ), le fichier concerné doit exister dans le répertoire du script et 
ne doit pas être ouvert à ce moment précis, ce qui n'est jamais garanti s'il est utilisé dans 
le code d'un script susceptible d'être utilisé en ligne. Le nouveau nom du fichier ne doit 
pas correspondre à un fichier existant dans le répertoire, faute de quoi cela provoque une 
erreur et l'arrêt du script. 

Il est recommandé de réserver l'usage de cette fonction aux cas de téléchargement de 
fichier du client vers le serveur, non sans s'assurer qu'aucun fichier du même nom 
n'existe sur le serveur dans le même répertoire. 

La syntaxe de la fonction renameC ) est la suivante : 

I boolean rename(string "nom_actuel " .string "nom_futur") 

Elle retourne TRUE si l'opération est effectuée et FALSE dans le cas contraire. 

Effacer un fichier 

Pour supprimer définitivement un fichier présent dans le même répertoire que le script 
qui effectue l'opération, il faut appeler la fonction uni ink( ), avec comme unique paramè- 
tre le nom du fichier à supprimer contenu dans une chaîne de caractères. La fonction 
retourne TRUE ou FALSE selon que la suppression est effectuée ou non. 

Avant de réaliser cette suppression, vous devez vous assurer que le fichier existe à l'aide 
de la fonction fi 1 e^exi sts ( ) (voir la section suivante), faute de quoi une erreur d'exécution 
est produite. 

Le code suivant : 

i f (f ile_exi sts ( "votes. bak")) 

{$result= (unlinkC'votes.bak"))? "Suppression réalisée" : "Echec de 
^la suppression";} 
el se 

{echo "Le fichier n'existe pas dans ce répertoire! <br>";} 

supprime le fichier votes. bak après avoir vérifié qu'il existe et affiche un message de 
confirmation si l'opération est réussie. 



Informations sur les fichiers 

Vous pouvez également obtenir des informations utiles sur les fichiers présents sur le 
serveur, comme la vérification de leur présence, leur taille, leur type, leur date de création 
ou de modification. 



Existence d'un fichier 

Pour éviter certaines erreurs qui arrêtent irrémédiablement les scripts, il est souvent 
indispensable de vérifier qu'un fichier existe réellement avant d'effectuer des opérations 
d'ajout, de lecture ou de suppression. 
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La fonction suivante : 

I boolean file_exists(string "noni_fichier") 

retourne une valeur booléenne TRUE ou FALSE selon que le fichier existe ou non dans le 
dossier du script qui l'appelle. 

Vous avez déjà utilisé cette fonction sans la connaître en conjonction avec la fonction 
touch( ) pour créer un fichier, s'il n'existait pas encore. Vous aviez alors le code suivant : 

Iif ( !file_exists( "monfich.txt" ) ) { 
touch( "monfich.txt" ,tinie( ) ) ; ) 

qui créait le fichier monf i ch . txt uniquement après avoir vérifié qu'il n'existait pas déjà. 



Taille des fichiers 

Vous pouvez vérifier la taille d'un fichier au moyen de la fonction suivante : 
^ integer filesizeCresource $id_file) 

qui retourne un entier représentant le nombre d'octets du fichier et 0 en cas d'erreur. Vous 
obtenez également la valeur 0 si le fichier est vide, par exemple s'il vient d'être créé à 
l'aide de la fonction touch( ). 

Associée à la fonction fseekC ), que vous avez déjà utilisée, la fonction integer files ize( ) 
permet de lire une partie seulement du fichier, qui sera exprimée en pourcentage ou frac- 
tion de sa taille totale. 

Pour éliminer 90 p. 100 des données du début du fichier, quelle que soit sa taille, et en 
lire les 10 p. 100 restants, vous auriez, par exemple : 

I fseek($id_file. floor(0.9 *filesize ($id_f11e))) 

Le résultat de l'opération 0.9*filesize($id_file) risquant d'être un décimal, vous utili- 
sez la fonction f 1 oor{ ) pour vous assurer que le paramètre est entier. 

Informations diverses 

Avant d'effectuer des opérations sur un fichier, il est possible de vérifier s'il s'agit bien 
d'un fichier et non d'un répertoire, par exemple, ou encore de savoir quel type d'opéra- 
tion vous pouvez réaliser sur ce fichier. 

Pour vérifier qu'il s'agit d'un fichier, vous avez à votre disposition la fonction suivante : 
I boolean 1s_file(string noin_f1chier) 

qui retourne la valeur booléenne TRUE pour le fichier ouvert identifié par $i d_f i 1 e et FALSE 
s'il ne s'agit pas d'un fichier. 

Vous pouvez également vérifier si le fichier identifié est disponible en lecture ou en écri- 
ture à l'aide des fonctions suivantes : 

I boolean 1s_readable(string noin_fichier ) 
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qui retourne TRUE si le fichier est lisible et FALSE dans le cas contraire, et : 
I boolean is_writable(string noni_fichier ) 

qui retourne TRUE si le fichier est disponible en écriture et FALSE dans le cas contraire. 

Vous pouvez aussi vérifier si le fichier provient d'un téléchargement avec la méthode 
POST à l'aide de la fonction suivante : 

^ boolean is_uploaded_file(string noin_fichier) 

qui retourne TRUE si c'est le cas et FALSE dans le cas contraire. Cette fonction est utilisée 
après le transfert de fichier du poste client vers le serveur. 

Pour savoir si vous avez affaire à un fichier ou à un répertoire, il vous faut recourir à la 
fonction fi 1 etype( ), dont la syntaxe est la suivante : 

I string filetype(string "nom_fichier") 

Cette fonction retourne la chaîne "f i 1 e" si le paramètre est un fichier et "di r" si c'est un 
répertoire. 

Informations de date 

Pour savoir si un script a accédé à un fichier ou s'il a été modifié depuis une date donnée, 
il existe plusieurs fonctions donnant les informations de date. Comme ces fonctions ne 
donnent pas une date en clair mais retournent un timestamp UNIX illisible pour le 
commun des mortels, il faut faire appel aux fonctions de date (voir le chapitre 8) pour 
afficher un résultat en clair. 

C'est ce que réalise l'exemple ci-dessous en utilisant la fonction date( ). 
Les fonctions à votre disposition sont les suivantes : 

• integer fileatime(string "nom_fichier"), qui retourne le timestamp de la date du 
dernier accès au fichier dont le nom est donné dans la chaîne de caractères passée en 
paramètre. 

• integer filenitime(string "norti_fichier"), qui retourne le timestamp de la dernière 
modification du fichier dont le nom est donné dans la chaîne de caractères passée en 
paramètre. 

• integer filectime(string "norti_fichier"), qui retourne le timestamp de la dernière 
modification des permissions du fichier dont le nom est donné dans la chaîne de carac- 
tères passée en paramètre. 

Dans l'exemple 11-7, cette date est différente de celle de la dernière modification. 
Exemple 11-7. Informations de date sur les fichiers 

<?php 

$fi 1 e="votes .txt" ; 
$datel= fileatime($file) ; 
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echo "Le dernier accès au fichier $file date de : 
'*".date("d/m/Y H:i :s" Jdatel) , "<br>" ; 
$date2= filemtime($file) : 

echo "La dernière modification du fichier $file date de : 
'•".date("d/m/Y H:i :s" ,$date2) . "<br>" : 
$date3= filectime($file) : 

echo "La dernière modification des permissions du fichier Sfile est : 

^",date("d/m/Y H:i :s" ,$date3) . "<br>" ; 

?> 

Le résultat du script est le suivant : 



Le dernier accès au fichier votes.txt date de : 30/10/2008 21:33:45 
La dernière modification du fichier votes.txt date de : 30/10/2008 21:33:45 
La dernière modification des permissions du fichier votes.txt est : 
27/10/2008 20:09:04 



Chemin d'accès à un fichier 

Vous pouvez récupérer le chemin d'accès complet à un fichier en connaissant simple- 
ment son nom. Cela permet d'y avoir accès en lecture, par exemple, sans être sûr qu'il se 
trouve dans le même dossier que le script qui l'utilise. 

Pour cela, vous utilisez la fonction suivante, accessible uniquement depuis PHP 4 : 

I string realpathCstring "nom_fichier") 

qui retourne le chemin complet dans une chaîne de caractères. 

Par exemple : 

I echo realpath("fichiers7.php"); 
affiche le résultat suivant : 



c:\program files\wampserver\www\php5\cllfichiers\fichiers7.php 

A l'inverse, vous pouvez extraire uniquement le nom d'un fichier en indiquant le chemin 
d'accès comme paramètre de la fonction : 

I string basename(string "chemin_d'accès") 

Le chemin d'accès précisé peut être partiel, comme dans le code suivant : 

I echo basename("./php5/listingll.7.php") 

ou une adresse URL complète, comme ci-dessous : 

I basename("http://www.monsite.Drg/php5/l istingll.7.php" ) 

Les deux possibilités retournent la chaîne : "listingll.7.php". 
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Mémo des fonctions 

boolean copy(string noiii_im't, string nom_fin) 

Crée une copie du fichier nom_init sous le nom nom_fin et retourne TRUE si l'opération est réussie. 

boolean fcl ose( resojrce $id_file) 

Ferme le fictiier identifié par $ i d_f i 1 e. 

boolean foef( resource $id_file) 

Retourne TRUE si le pointeur atteint la fin du fichier. 

string fgetc( resource $id_file) 

Retourne un seul caractère du fichier identifié par $i d_f i 1 e et pointe sur le caractère suivant, 
array fgetcsv(resource $id_file, int nb, string delim) 

Retourne tous les éléments de la ligne en cours du fichier identifié par $i d_f i 1 e avec un nombre maximal de caractères. 
Les éléments du fichier sont séparés par le caractère précisé par del im (la virgule par défaut), chacun étant un élément 
du tableau retourné. 

string fgets(resource $id_file, int nb) 

Retourne toute la ligne en cours du fichier identifié par $id_f i 1 e avec un nombre maximal de nb caractères, 
string fgetss(resource $id_file, int long) 

Effectue la même opération que la fonction f gets ( ) en éliminant de la chaîne retournée les balises HTML qui s'y trouvent. 

boolean file_exists(string nom_fichier) 

Retourne TRUE si le fichier existe et FALSE dans le cas contraire. 

array fileCstring noin_fictiier, int ctiemin) 

Retourne toutes les lignes du fichier dans les éléments d'un tableau. 

int fileatimeCstring nom_fictiier) 

Retourne la date du dernier accès au fichier. 

int filectime(string nom_ficfiier) 

Retourne la date de la dernière modification des permissions du fichier. 

int fileintime(string noni_ficfiier) 

Retourne la date de la dernière modification du fichier. 

int filesize(string nom_fichier) 

Retourne la taille du fichier en octets. 

string filetype (string nom_fichier) 

Retourne "f il e" s'il s'agit d'un fichier et "di r" si c'est un répertoire. 

boolean flock(resource $id_file, int mode) 

Verrouille/déverrouille le fichier identifié par $id_f i 1 e en fonction de la valeur de la constante mode. Le fichier doit avoir 
été ouvert. Les valeur de mode sont les suivantes : 
LOCK_SH (ou 1) pour verrouiller en lecture seule par tous ; 

LOCK_EX (ou 2 ) pour verrouiller en lecture et en écriture pour les autres utilisateurs ; 
LOCK_UN (ou 3) pour déverrouiller le fichier. 



Les fichiers 

Chapitre 1 1 



resource fopen(string nom_fichier, string mode, int chemin) 

Ouvre le fichier dont vous précisez le nom et le mode d'accès ctioisi parmi les valeurs suivantes : 
"r" : accès en lecture seule, pointeur au début du fictiier 
"r+" : accès en lecture et écriture, pointeur au début du fichier 

"w" : accès en écriture seule, pointeur au début du fichier. Efface le contenu du fichier et le crée s'il n'existe pas. 
"w+" : accès en lecture et écriture, pointeur au début du fichier Efface le contenu du fichier et le crée s'il n'existe pas. 
"a" : accès en lecture seule, pointeur en fin de fichier Crée le fichier s'il n'existe pas. 
"3+" : accès en lecture et écriture, pointeur en fin de fichier. Crée le fichier s'il n'existe pas. 

La fonction retourne un identifiant de fichier qui est utilisé comme paramètre par un grand nombre de fonctions de lecture/ 
écriture. 

Le paramètre chemi n permet d'élargir la recherche du fichier aux sous-dossiers s'il vaut 1 . 
int fpassthruC resource $id_file) 

Lit le contenu du fichier situé après le pointeur et envoie le contenu vers la sortie standard. 

string fread( resource $id_file, int nb) 

Lit un nombre nb de caractères dans le fichier identifié par $id_f i 1 e. 

int fseek( resource $id_file, int nb) 

Déplace le pointeur de fichier à la position nb. 

int ftel 1 ( resource $id_file) 

Retourne la position en cours du pointeur de fichier 

int fwr1te( resource $id_file, string texte, int nb) 

Écrit le nombre maximal nb de caractères de la chaîne texte dans le fichier identifié. 

boolean is_file( string nom_fichier) 

Retourne TRUE si le fichier existe et FALSE dans le cas contraire. 

boolean is_readable(string nom_fichier) 

Retourne TRUE si le fichier est accessible en lecture et FALSE dans le cas contraire, 
boolean is_uploaded_file(string nom_fictiier) 

Retourne TRUE si le fichier provient d'un téléchargement par la méthode POST et FALSE dans le cas contraire, 
boolean is_writable(string nom_fichier) 

Retourne TRUE si le fichier est accessible en écriture et FALSE dans le cas contraire. 

int readfile(string nom_fictiier, boolean chemin) 

Lit la totalité du fichier et l'envoie vers la sortie standard. 

string realpath(string nom_fichier) 

Retourne le chemin d'accès complet du fichier 

boolean rename(string nom_ancien, string nom_nouveau) 

Renomme le fichier nom_ancien en nom_nouveau et retourne TRUE si l'opération s'est bien exécutée, 
boolean rewind(resource $id_file) 
Replace le pointeur de fichier au début 
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resource tmpf i 1 e( ) 

Crée un fichier temporaire qui sera effacé en fin de connexion. 

boolean touch(string nom_fichier, int nouv_date [,int ex_date]) 

Modifie la date de dernière modification du fichier et retourne TRU E si l'opération est réussie. Crée le fichier s'il n'existe pas 
encore. 

boolean uni ink(string noni_fichier) 
Efface le fichier dont le nom est donné. 

Exercices 

Exercice 1 

Créez un fichier pour enregistrer la date de chaque connexion à votre site. Procédez 
ensuite à la lecture des données, puis calculez des statistiques sur ces dates. 

Exercice 2 

Créez un fichier texte pour enregistrer le code du navigateur client sous forme d'enregis- 
trements de longueur fixe (du type "E6" pour Internet Explorer 6) suivis d'un séparateur 
fixe. Il est possible d'utihser la variable $_SERVER[ 'HTTP_USER_AGENT' ] pour identifier le 
navigateur client. Après lecture du fichier, réalisez des statistiques sur ces données. 

Exercice 3 

En vous inspirant de l'exemple 11-5, créez un livre d'or qui n'affiche que les cinq 
derniers avis donnés par les visiteurs du site. 

Exercice 4 

Créez une loterie en ligne en enregistrant le numéro gagnant dans un fichier texte. Le 
visiteur saisit sa proposition dans un formulaire, et la réponse est affichée après compa- 
raison avec la solution. 

Exercice 5 

Créez un questionnaire en ligne dont les questions et les réponses sont contenues dans 
deux fichiers séparés. Au démarrage, lisez le fichier des questions et affichez -les dans un 
formulaire, chacune étant suivie d'une zone de saisie de texte pour la réponse ou de 
boutons radio pour des réponses par oui ou par non. Après envoi du formulaire complet, 
vérifiez chacune des réponses, et affichez le score. 
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Ce chapitre aborde les différentes méthodes qui permettent de conserver des informa- 
tions pour améliorer le service rendu par un site. Il peut s'agir de conserver des choix fait 
par un visiteur entre deux visites pour adapter le contenu de la page d'accueil aux besoins 
de ce dernier. C'est ce que permettent les cookies. Il est en outre possible de conserver 
des informations saisies dans une page et de les rendre accessibles à toutes les autres 
pages d'un même site. Le mécanisme de session autorise ce type d'action, qui est à la 
base de la gestion de panier utilisée sur tous les sites de commerce en ligne. 

Toujours dans le but d'améliorer le service rendu aux visiteurs ou aux clients d'un site, la 
fin du chapitre traite de l'envoi d'e-mails à partir du serveur du site vers le poste client ou 
tout autre destinataire, comme le font, par exemple, les sites de vente en ligne pour 
envoyer des confirmations de commande. 

Les cookies 

Les cookies sont de petits fichiers qui peuvent être écrits par un script PHP ou par 
d'autres langages, tel JavaScript, sur l'ordinateur du visiteur. A l'exception du piratage, 
c'est le seul cas où un site peut intervenir sur le disque dur d'un utilisateur. 

Lors de sa création par Netscape, cette possibilité a effrayé plus d'un internaute, bien 
qu'elle ne présentait pas de danger réel. Chaque utilisateur garde de surcroît la possibilité 
de désactiver l'écriture des cookies en paramétrant son navigateur, mais certains services 
en ligne ne fonctionnent que si les cookies sont activés sur le poste client. Il peut aussi les 
effacer à sa guise puisqu'ils se trouvent sur son ordinateur. 

Par défaut, Internet Explorer ou Firefox écrivent les cookies sans autorisation de l'utilisa- 
teur, tandis que Netscape (plus guère utilisé il est vrai) demandait l'accord du visiteur 
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pour chaque cookie à écrire. Vous n'avez donc jamais la certitude de pouvoir écrire vos 
cookies pour chaque visiteur. 

Les cookies font l'objet de limites d'emploi. Un site donné ne peut écrire que 20 cookies 
sur un même poste client. Chacun d'eux ne doit pas dépasser 4 Ko, ce qui empêche le 
stockage d'information de taille importante. Sauf spécification contraire, un cookie n'est 
accessible que par le site qui l'a écrit. L'utilisation des cookies est donc généralement 
limitée au stockage d'information de petite taille, comme le nom, le code d'accès, 
l'adresse ou les préférences de l'utilisateur. L'usage courant est de stocker les coordon- 
nées qu'un visiteur a saisies dans un formulaire et de les lire lors d'une prochaine 
connexion pour remplir automatiquement le même formulaire, permettant ainsi aux visi- 
teurs de gagner du temps. Les cookies sont aussi employés par le mécanisme de session, 
que nous allons aborder par la suite. Il va de soi que, de par leur mode de stockage, les 
cookies ne sont pas récupérables si l'utilisateur se reconnecte à partir d'un poste diffé- 
rent, contrairement à ce qu'il est possible de faire si les informations sont inscrites dans 
une base de données. 

Écriture des cookies 

Pour écrire un cookie, comme pour envoyer des en- têtes au moyen de la fonction 
headerO, il est impératif qu'aucun contenu XHTML n'ait été envoyé au poste client 
avant l'écriture du cookie. Autrement dit, aucune instruction PHP d'affichage, ne serait- 
ce que pour afficher un seul caractère, ne doit figurer dans le script avant la fonction qui 
va créer le cookie. 

Pour écrire un cookie, vous utilisez la fonction setcookieO, dont la syntaxe est la 
suivante : 

Iboolean setcookieCstring nom_cookie, [string valeur, integer datefin, 
**string chemin, string domaine, integer sécurité] ) 

Les paramètres de la fonction setcookieO sont les suivants : 

• nom^cooki e est une chaîne définissant le nom du cookie. Ce nom obéissant aux mêmes 
règles de nommage que les variables, il faut éviter les caractères spéciaux. Ce nom sert 
à identifier le cookie pour les opérations de lecture de leur contenu. 

• valeur contient la valeur associée au cookie. Il s'agit d'une chaîne de caractères, même 
pour un nombre. Il y a donc lieu d'effectuer au besoin un transtypage (voir le chapi- 
tre 2) pour effectuer des calculs avec cette valeur. 

• datefin est un entier qui permet de stocker un timestamp UNIX exprimé en seconde 
(voir le chapitre 8) définissant la date à partir de laquelle le cookie n'est plus utilisable. 
Si ce paramètre est omis, le cookie n'est valable que pendant le temps de connexion du 
visiteur sur le site. Pour définir cette date, vous utilisez le plus souvent la fonction 
time( ), qui donne le timestamp en cours, auquel vous ajoutez la durée désirée par un 
nombre de seconde. Pour une durée de validité de vingt-quatre heures, par exemple, 
vous écrivez time( ) +86400. 
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• chemin définit dans une chaîne le chemin d'accès aux dossiers qui contiennent les 
scripts autorisés à accéder au cookie. Les scripts contenus dans les sous-dossiers 
éventuels de ce dossier ont également accès au cookie. Si la valeur est /, le cookie 
est lisible sur l'ensemble du domaine domai ne. Si la valeur est /repertoi re/, le cookie est 
uniquement lisible dans le répertoire /répertoire/ ainsi que tous ses sous-répertoires 
(/repertoi re/sousrep/ par exemple) du domaine domaine. La valeur par défaut est le 
répertoire qui contient le script ayant créé le cookie. 

• domaine définit le nom entier du domaine à partir duquel vous pouvez accéder au 
cookie. Vous écrivez, par exemple, www.mondomaine.com, et non mondomaine.com seule- 
ment. Lorsque ce nom de domaine est le même que celui qui a créé le cookie, ce qui 
est le cas le plus fréquent, vous pouvez omettre ce paramètre. 

• sécurité est une valeur de type boolean qui vaut TRUE (ou la valeur 1) si le cookie 
doit être transmis par une connexion sécurisée (avec une adresse du type https:// 
www.mondomaine.com) et FALSE (ou la valeur 0) dans le cas contraire, qui est la valeur par 
défaut. 

La fonction setcookieO renvoie une valeur booléenne TRUE qui permet de contrôler si 
l'écriture du cookie a eu lieu et FALSE en cas de problème (si le navigateur client refuse les 
cookies, par exemple). 

L'exemple 12-1 écrit plusieurs cookies en utilisant les différents paramètres possibles. 
Exemple 12-1. Écriture de cookies avec différents paramètres 

<?php 

//cookie valable uniquement pour la session 
setcookie("prenom"."Jan") ; O 

//cookie valable 24 heures 

setcookie( "nom" , "Geel sen" .time( )+86400) ; <— © 

//Ce cookie utilise tous les paramètres 

setcookie("CB" ."5612 1234 5678 1234", time()+86400. "/client/paiement/", 

^"www.funxhtml .com",TRUE); <— © 

?> 

Le premier appel de setcookieO ne définit que le nom et la valeur du cookie. Ce dernier 
n'étant valable que pendant la durée de la session, cette valeur n'est récupérable que pour 
une autre page du même site et non pour une prochaine connexion (repère O). Le 
deuxième appel crée un cookie valable vingt-quatre heures, soit 86 400 secondes 
(repère 0). Le troisième appel crée un cookie utilisant tous les paramètres possibles 
(repère 0). 

Pour effacer le contenu d'un cookie, il suffit d'utiliser la fonction setcookieO en n'utili- 
sant que le paramètre nom_cookie sans lui affecter de valeur. 

La fonction suivante : 

I setcookie( "nom" ) 

efface la valeur précédente donnée au cookie nommé "nom". 
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Pour faire disparaître un cookie, vous devez définir une date de validité antérieure à la 
date actuelle en conservant la valeur utilisée lors de sa définition. 

Le code suivant : 

I setcookie("cb","5612 1234 5678 1234" .time( )-3600) 

rend le cookie inaccessible mais seulement lors du rechargement de la page qui contient 
ce code. 

Vous pouvez écrire plusieurs valeurs sous un même nom de cookie en utilisant la nota- 
tion à crochets des tableaux. 

Le code suivant : 

setcookieC "client [prénom]" , "Jan" ,time( )+3600) ; 
setcookieC "cl ientCnom]" , "Geel sen" ,tiine( )+3600) ; 
setcookieC "cl ient[vill e]" , "Paris" ,tiiïie( )+3600) ; 

enregistre un cookie nommé "client" contenant trois valeurs utilisables pendant une 
heure. 



Écriture des clés 

Dans la définition des cool<ies, les clés des tableaux ne sont pas délimitées par des guillemets, contraire- 
ment à l'usage habituel dans les tableaux. 



Vous pouvez écrire des cookies à l'aide de boucles à partir des éléments d'un tableau. 
L'exemple 12-2 suivant écrit le cookie "client2", valable deux heures, contenant trois 
valeurs en provenance du tableau Stabcook. 

Exemple 12-2. Écriture de cookies à partir d'un tableau 

<?php 

$tabcook = array( "prenom"=>"Paul " , "nom"=>"Char" , "vil 1 e"=>"Marsei 11 e" ) ; 

foreach($tabcook as $cl e=>$val eur) 

{ 

setcookie("cl ient2[$cle]" ,$valeur,time( )+7200) ; 

} 

?> 

Lecture des cookies 

Les données stockées dans les cookies ne sont récupérables dans la page qui les a créés 
que lors d'un rechargement de cette page. Les autres pages du site ont un accès immédiat 
aux cookies dès leur chargement. Cela procure un moyen de passage d'information d'une 
page à l'autre, même s'il y en a de plus commodes. 

Il existe deux manières de récupérer la ou les valeurs d'un cookie, dans une variable de 
même nom que celui attribué au cookie ou dans le tableau associatif superglobal $_COOKIE. 
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Dans le cas où la variable a le même nom que le cookie, cette variable peut être scalaire 
ou un tableau, selon le moyen utilisé pour créer le cookie. Cette possibilité n'est toutefois 
plus valable depuis la version 4.1 de PHP, à moins d'activer la directive register_globals 
du fichier php. i ni, ce qui n'est plus le cas par défaut. En tout état de cause, cette méthode, 
considérée comme obsolète, est appelée à disparaître. 

Avec le tableau associatif superglobal $_COOKIE, vous utilisez comme clé de l'élément 
recherché le nom du cookie. Ce tableau n'étant disponible que depuis la version 4.1 
de PHP, il faut utiliser pour les versions antérieures le tableau $HTTP_COOKIE_VARS. La 
nouvelle méthode est désormais recommandée. C'est donc celle que vous utiliserez 
exclusivement dans la suite du chapitre. 

Dans le cookie simple suivant : 

I setcookie( "nom" , "Geel sen" ,time( )+1000) 

vous récupérez l'information dans la variable $_COOKIE["noni"]. 

Pour le cookie sous forme de tableau suivant : 

<?php 

setcookie( "achat [premier]" , "1 i vre" ,time( )+3600) ; 
setcookie( "achat [deuxième] " , "CD" ,time( )+3600) ; 
setcookieC "achat [troisième]" , "vidéo" ,time( )+3600) ; 
?> 

vous lisez toutes les données dans le tableau $_COOKIE["achat"]. Il s'agit d'un tableau à 
deux dimensions, que vous pouvez parcourir à l'aide d'une boucle foreach : 

foreach($_COOKIE["achat"] as $cl e=>$val eur) 
{ 

echo "Le cookie nommé: $cle contient la valeur : $valeur <br />"; 

} 

Après avoir rechargé la page dans le navigateur, vous obtenez l'affichage suivant : 



Le cookie nommé: premier contient la valeur : livre 
Le cookie nommé: deuxième contient la valeur : CD 
Le cookie nommé: troisième contient la valeur : vidéo 



Vous pouvez aussi accéder individuellement à chaque valeur. 
Pour récupérer la valeur "1 i vre", par exemple, vous écrivez : 
I $_COOKIE["achat"][ "premier"] 



Exemple de page avec cookies 

L'exemple 12-3 réalise un sondage en ligne, dans lequel un seul vote est autorisé. Pour 
contrôler que personne ne triche, vous écrivez deux cookies, le premier pour vérifier 
qu'un vote a eu lieu et le second pour enregistrer le vote. La durée de validité des cookies 
est celle du sondage, exprimée en secondes (un jour = 86 400 secondes). 
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Dans le code de l'exemple, la durée de vie des cookies est fixée à 60 secondes, ce qui 
n'est guère réaliste mais tout à fait intentionnel. Cela vous permet de tester que vous 
pouvez enregistrer un nouveau vote après ce délai. Dans la pratique, la durée devrait être 
celle choisie pour le sondage. 

Lorsque l'utilisateur valide le formulaire, le script commence par contrôler l'existence 
d'un cookie indiquant s'il existe déjà un vote, ici le cookie "votant" (repère©), et la 
valeur de ce vote, ici le cookie "vote" (repère ©). Si un vote est déjà enregistré, une boîte 
d'alerte JavaScript affiche un message indiquant qu'il est impossible de voter deux fois 
(repère 0) et rappelle le vote précédent. 

S'il a voté, une boîte d'alerte JavaScript affiche la valeur du premier vote. Dans le cas 
contraire, les deux cookies sont enregistrés, puis une boîte d'alerte de remerciement 
s'affiche (voir la figure 12-1). Dans la réalité, chaque vote doit évidement être enregistré 
sur le serveur, dans un fichier texte, par exemple, de façon à pouvoir afficher les résultats 
du vote (voir le chapitre 11 pour réaliser cet enregistrement), ou dans une base de 
données (voir les chapitres 14 à 18). 

Le script est découpé en plusieurs morceaux, délimités par les balises habituelles <?php et 
?>. Entre ces morceaux de scripts sont incorporés les éléments XHTML destinés à affi- 
cher les boîtes d'alertes. 

La suite du fichier est le code XHTML créant l'interface visible du sondage, constituée 
de boutons radio portant tous le même nom, ce qui les rend exclusifs et n'autorise qu'un 
seul choix. 

Exemple 12-3. Sondage avec vérification des votes 

<?php 

//1er partie du script PHP 
if(isset($_POST["choix"])) 
{ 

if($_COOKIE["votant"] $_COOKIE["vote"] ) <-© 

{ 

$vote = $_COOKIE["vote"]: 

?> 

<!--Code JavaScript --> 

<script type="text/javascript" > 

alerte 'Vous avez déjà voté pour <?php echo $vote ?>!')<— 0 

</script> 
<!-- 2 eme partie du script PHP--> 
<?php 
} 

else 
{ 

$vote = $_COOKIE["vote"]: 

setcookieC "votant" , "true" .time( )+300) ; 

setcookie( "vote". "{$_POST[' choix' ]}",time()+300): 

//enregistrement du vote dans un fichier --> voir chapitre 11 

if (fil e_exists(" sondage.txt") ) 

{ 
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if ($id_fi 1 e=fopen( "sondage. txt" , "a") ) 
{ 

flock($id_file,2): 

fwrite($id_file,$_POST[' choix' ]."\n"); 

flock($id_file.3): 

fclose($id_file) : 

) 

el se 

{ echo "Fichier inaccessible";} 

} 

el se 
{ 

$id_file=fopenC" sondage.txt" ."w") ; 
f wri te( $id_file.$_POST[' choix ']."\n"); 
fclose($id_file) ; 

} 

// Fin de l'enregistrement 

?> 

<!--Code JavaScript --> 

<script type="text/javascript" > 

alert( 'Merci de votre vote pour <?php echo $_POST["choix"] ?> ! ') 

</script> 
<!-- 3 eme partie du script PHP--> 
<?php 

} 

} 

?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xnilns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=iso-8859-l" /> 

<title>Sondage </title> 
</head> 
<body> 

<h2>Bienvenue sur le site PHP 5 </h2> 
<!-- "<?php echo $_SERVER[ ' PHP_SELF' ] ?>" — > 
<form method="post" action="<?php echo $_SERVER[ ' PHP_SELF' ] ?>"> 
<fieldset> 

<1 egend>Votez pour votre technologie Internet préférée</legend> 

<table><tbody> 

<tr> 

<td>Choix 1 : PHP/MySQL</td> 
<td> 

<input type="radio" name="choix" value="PHP et MySQL" /> 
</td> 
</tr> 
<tr> 

<td>Choix 2 : ASP.Net</td> 
<td> 

<input type="radio" name="choix" value="ASP.Net" /> 
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</tcl> 
</tr> 
<tr> 

<td>Choix 3 : JSP </td> 
<td> 

<input type="radio" name="choix" value="JSP" /> 
</td> 
</tr> 
<tr> 

<td><b>Votez ! </b></td> 
<td> 

<inpLit type="subinit" value="ENVOI" /> 
</td> 
</tr> 
</tbody> 
</table> 
</fieldset> 
</form> 



</body> 
</html> 
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Figure 12-1 

Page de sondage utilisant cookies et boîtes d'alerte JavaScript 



Les sessions 

Le protocole HTTP, que vous utilisez chaque fois que vous voulez visualisez une page 
Web, est un protocole de transmission dit sans état. En d'autres termes, quand vous 
entrez l'adresse d'un site dans votre navigateur, le protocole HTTP la transmet au serveur 
puis vous renvoie le fichier XTML correspondant avant de passer aussitôt à autre chose. 
Si, à partir de la page d'accueil, vous cliquez sur un lien vers une autre page du même 



Cookies, sessions et e-mails H 
Il il B 

site, rien ne lui permet de savoir que ces deux requêtes émanent du même poste client. Il 
est donc a priori impossible de conserver des informations provenant d'une page pour les 
utiliser dans une autre. 

L'introduction du support des sessions dans la version 4 de PHP permet de conserver ces 
informations de façon simple et de les réutiliser dans toutes les pages d'un site pour un 
même visiteur. Aucun autre visiteur n'a accès à ces données. 

Le mécanisme des sessions 

L'utilisation du mécanisme des sessions obéit aux étapes générales suivantes : 

1. Ouverture d'une session dans chaque page ayant accès aux données à l'aide de la 
fonction session_start( ) de syntaxe : boolean session_start( ). Dans la plupart des cas, 
c'est-à-dire quand les sessions utilisent des cookies, cet appel est la première instruc- 
tion du script. 

2. Chaque utilisateur se voit attribuer un identifiant de session, qui est une suite de 
26 caractères aléatoires. Lié à la session en cours, et donc différent lors d'une autre 
connexion, cet identifiant est transmis d'une page à une autre de deux manières diffé- 
rentes, soit en étant écrit dans un cookie sur le poste client, soit en étant ajouté à 
l'URL de la page cible d'un lien. 

3. Définition des variables de session, c'est-à-dire des valeurs qui seront accessibles 
dans toutes les pages du site qui utilisent la fonction session_start( ). Cela se réalise 
en utilisant le tableau superglobal $_SESSION, dont les clés sont les noms des variables. 
A la différence des cookies, les noms et valeurs des variables sont stockés sur le 
serveur et non sur le poste client. Les variables sont généralement stockées dans le 
dossier /tmp du serveur, mais il vous appartient de vérifier auprès de votre hébergeur 
le nom du dossier de stockage, certains d'entre eux vous obligeant à créer vous-même 
sur le serveur un dossier nommé, par exemple, sessions. En l'absence d'un tel 
dossier, les sessions ne fonctionnent pas. Les fichiers contenant les données ont pour 
nom l'identifiant de session, auquel est ajouté le préfixe sess_. Ils ont la même struc- 
ture qu'un fichier texte. 

4. Lecture des variables de session dans chaque page en fonction des besoins à l'aide du 
tableau superglobal $^SESSION. 

5. Fermeture de la session après destruction éventuelle des variables de session. 

Session avec cookie 

La manière la plus simple de transmettre l'identifiant de session est d'utiliser un cookie. 
Il faut pour cela que la directive sessi on . use_cooki es du fichier php . i ni ait la valeur on et 
plus fondamentalement que le poste client accepte les cookies. C'est pour cette raison 
que l'on voit couramment sur les sites de commerce en ligne un avertissement du type 
« pour accéder à ce service, vous devez accepter les cookies ». Vous verrez par la suite 
comment gérer les sessions en cas de refus absolu des cookies par le client. 
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Vous n'avez pas à coder vous-même dans le script l'écriture du cookie, PHP se chargeant 
de l'envoyer immédiatement quand vous appelez la fonction session_start( ) pour la 
première fois. Si ces conditions sont remplies, vous n'avez à vous préoccuper de rien, si 
ce n'est de faire commencer chaque page par l'appel de la fonction sessi on_start( ). 



La directive session.autojstart 

Si la directive session. auto_start a la valeur on, vous n'avez même pas à utiliser la fonction 
session_start( ), le serveur s'en chargeant pour toutes les pages du site. Cette directive est toutefois 
rarement activée. 



Les variables de session sont définies par le biais du tableau $_SESSION de la manière 
suivante : 

I $_SESSION[ 'mavar' iïiavaleur; 
ou encore : 

I $_SESSION[ 'mavar' Smavariable; 

La valeur est ensuite lisible dans toutes les pages en écrivant simplement : 
I echo $_SESSION['mavar']: 

L'utilisation des sessions se révèle donc beaucoup plus simple qu'il n'y paraît. 

Le code de gestion élémentaire de session comprendrait, par exemple, les deux pages 
suivantes : 

• La première page démarre une session (repère Q) puis enregistre une variable de 
session (repère ©) et crée un lien vers la deuxième page, nommée "deux. php" : 

<?php 

session_start( ) ; <— O 
$nom="Jean" ; 

$_SESSION['nom']=$noni; <-© 

echo "<a href=\"cleux. php\">Vers la page DEUX </a>"; 
?> 

• La deuxième page démarre également une session (repère ©) puis a accès à la varia- 
ble de session de la page précédente (repère O) '■ 

<?php 

session_start( ) ; <— © 

echo "<br /> Bonjour ",$_SESSION['nom']: <— © 

Pages à accès réservé par une authentification 

Vous allez maintenant créer une application plus complète utilisant le mécanisme des 
sessions. 

L'exemple 12-4 suivant est composé de trois fichiers correspondant à trois pages du site. 
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L'objectif est de limiter l'accès du site aux seuls utilisateurs enregistrés dotés d'un login 
et d'un mot de passe. 

f*' Exemple 12-4. Accès réservé et identification 

Cet exemple est constitué de trois fichiers, pageindex.php, pagehtml .php et pagephp.php. 

Sur la page d'accueil, le script crée un formulaire classique d' authentifie ation, dans 
lequel le visiteur doit saisir son login et son mot de passe (voir la figure 12-2). 

Le script commence par ouvrir une session (repère O) puis vérifie si le login et le code 
sont corrects (repère 0). Il va de soi que sur un site réel le login et le code ne figureraient 
pas dans le script mais seraient lus dans une base de données. 

Si l'accès est autorisé, la variable $_SESSION[ 'accès ' ] est définie avec la valeur "oui " et la 
variable $_SESSION['nom'] récupère le login du visiteur. Cette page contient deux liens 
vers les pages XHTML et PHP et affiche le nombre de fois que chaque page a été vue 
pendant la session. Vous utilisez pour cela les variables $_SESSION['html '] et $_SESSION 
['php'], dont les valeurs sont définies dans les fichiers pagehtml .php et pagephp.php. Cela 
montre bien qu'une variable de session définie dans une page est visible dans les autres 
pages (repères 0 et ©). 

Script de la page d'accueil pageindex.php : 

<?php 

session_start( ) ; <— O 

if($_POST['login']=="Machin" && $_P0ST['pass']==-4567") <-0 
{ 

$_SESSION['acces'] = ''oui'': <— © 
$_SESSION[ ' nom' ]=$_POST[ ' 1 ogi n ' ] ; <-© 

} 

?> 

<!DOCTYPE html PUBLIC "-//WSCZ/DID XHTML Ll/ZEN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd''> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>LES SESSIONS</title> 

</head> 

<body> 

<div> 

<form method="post" action="<?php echo $_SERVER[ ' PHP_SELF' ] ?>"> 
<fieldset> 

<legend>Accès réservé aux personnes autorisées: Identifiez vous !</legend> 

<label>Login : </label><input type="text" name="login" /> 

<label>Pass :  </label><input type="password" name="pass" /> 

<input type="submit" name="envoi" val ue="Entrer"/> 

</fieldset> 

</form> 

Visiter les pages du site <br /> 
<ul> 
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<li><a href="pagehtml .php">Page XHTML </a><? if(isset($_SESSION['htmr])) 

*»echo " vue ". $_SESSION[ ' html ' ] . " fois"; ?> </li>'^0 

<li><a href="pagephp.php">Page PHP 5</a><? if(isset($_SESSION['php'])) 

^echo " vue ". $_SESSION[ 'php' ] . " fois"; ?> </li>'^0 

</ul> 

</div> 

</body> 

</html> 
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Figure 12-2 

Page d'accueil 

Les pages définies par les fichiers pagephp.php et pagehtml .php sont celles qui vont affi- 
cher le contenu informatif réservé. Elles ont une structure identique, et vous pourriez en 
créer une quantité sur le même modèle pour élargir le contenu du site. Chacune d'elles 
commence par démarrer une session (repères O). Elles sont protégées contre tout accès 
non autorisé, car si une personne essaye de les afficher directement dans un navigateur, 
elle est redirigée (repères©) vers la page d'accueil tant que la variable $_SESSION 
[ ' accès ' ] n'a pas la valeur "oui " (repères 0). 

Si l'accès est autorisé, le script affiche un message de bienvenue incorporant le nom du 
visiteur (repères 0) puis incrémente un compteur de visite pour la page (repères 0). Il 
affiche enfin à la suite des liens vers les autres pages le nombre de fois qu'elles ont été 
visitées (repères 0 et 0). 

Script de la page pagephp . php : 
I <?php 

I session_start( ) : <— 0 

r if($_SESSION[' accès ']! = "oui") <-0 

header("LDcation:pageindex.php") ; <— 0 

\ > 

I e1 se 
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{ 

echo "<h4>Bonjour ". $_SESSION[ 'nom' ] . "</h4>" ; 
$_SESSION['php'] ++: ^0 

} 

?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Ll/ZEN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang^'f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<title>La page de PHP 5</title> 

</head> 

<body> 

<h4> Accès réservé aux personnes autori sées</h4> 
<p> Visiter les autres pages du site : 

<?php echo "Page PHP vue ". $_SESSION['php']. " fois"; ?> •^O 
<ul> 

<li><a href="pageindex.php">Page d'accueil </a></li> 
<li><a href="pagehtml .php">Page XHTML </a> 

<? if(isset($_SESSION['htmr]))echo " vue ". $_SESSION[ ' html' ] . " fois"; ?> 

^</li> 

</ul> 

</p> 

<h3>Contenu de la page PHP 5</h3> 

</body> 

</html> 
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Figure 12-3 

Page PHP 



Script de la page pagehtml . php : 
I <?php 

I session_start( ) ; <— O 
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if($_SESSION[' accès ']! = "oui") <-© 
{ 

header("Location:pageindex.php") ; <— © 
} 

el se 
{ 

echo "<h4>Bonjour ". $_SESSION[ 'nom' ] . "</h4>" ; <-© 
$_SESSION['htnir] ++; ^0 

} 

?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Ll/ZEN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content=''text/html ; charset=i so-8859-1'' /> 

<title>La page du (X)HTML.</title> 

</head> 

<body> 

<h4> Accès réservé aux personnes autorisées</h4> 
<p> Visiter les autres pages du site : 

<?php echo "Page XHTML vue ". $_SESSION[ ' html' ] . " fois"; ?><-© 
<ul> 

<li><a href="pageindex.php">Page d'accueil </a> </li> 
<li><a href="pagephp.php">Page PHP 5</a> 

<? if(isset($_SESSION['php']))echo " vue ". $_SESSION['php']. " fois"; ÎX-Q 

</li> 

</ul> 

<h3>Contenu de la page XHTML</h3> 

</body> 

</html> 
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La gestion de panier 

Une utilisation classique des cookies est la gestion de panier sur un site de commerce en 
ligne dans lequel les articles sont sélectionnés les uns après les autres et stockés dans un 
panier, ou Caddie. 

L'exemple 12-5 demande de remplir un bon de commande en complétant un formulaire. 
Ce dernier ne permet la saisie que d'un article à la fois. La démarche serait la même si 
le client pouvait choisir des articles dans différentes pages et qu'il fallait conserver 
l'ensemble de ces choix jusqu'à la fin de sa commande. 



Dans la première version de PHP 5, il était possible d'utiliser le tableau $_SESSI0N en tant que tableau 
multidimensionnel. Pour enregistrer plusieurs valeurs de noms dans la même session on pouvait écrire : 

$_SESSION['nom'][]="Pierre": 

Puis, à la suite d'une autre saisie : 

$_SESSION['nom'][] = "Paur ; 

Et ainsi de suite. C'est de cette manière que nous avions traité l'exemple 12-5 dans la première édition de 
l'ouvrage, mais cette possibilité ne fonctionne désormais plus. 



Si la commande comportait plus d'un article, la saisie du premier article serait perdue 
lors de la saisie du deuxième. L'usage des sessions permet de conserver l'ensemble des 
articles saisis jusqu'à la fin de la commande. 

Le formulaire de saisie comprend trois zones de saisie ainsi que trois boutons Submit, 
chacun correspondant à une action particulière. Le bouton Ajouter ajoute un article à la 
commande, le bouton Vérifier affiche l'ensemble de la commande et le montant total et le 
bouton Enregistrer stocke la commande dans un fichier texte sur le serveur par commo- 
dité car, en réalité, il serait préférable de stocker les informations dans une base de données. 

La partie PHP du script est divisée en trois parties, chacune gérant une des actions 
possibles : 

• Si l'utilisateur clique sur le bouton Ajouter, le script récupère les informations dans les 
variables $code, $article et $prix (repères O, Q et 0) puis définit les variables de 
session $_SESSION['code'], $_SESSION[ ' arti cl e ' ] et $_SESSION['prix'] (repères O: © 
et 0). Pour sauvegarder les données de plusieurs saisies, nous les enregistrons dans la 
même variable en les concaténant et en les séparant par les caractères arbitrairement 
choisis « // », comme nous l'avons fait pour l'enregistrement de chaînes dans un 
fichier au chapitre 11. La variable $_SESSION['code'] contiendrait, par exemple, la 
chaîne suivante après la saisie de trois codes : "codel//code2//code3". 

• Si l'utilisateur clique sur le bouton Vérifier, le script affiche l'ensemble des lignes de 
la commande plus une ligne indiquant le prix total dans un tableau XHTML. Il nous 
faut d'abord récupérer toutes les valeurs enregistrées dans les chaînes précédentes. 
Ceci est fait en créant trois tableaux à l'aide de la fonction expl ode( ) appliquée succes- 
sivement aux trois variables de session (repères 0,0 et 0). Une boucle for permet 
alors d'afficher toutes les données en parcourant les trois tableaux créés (repère ©)■ 
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Le prix total est calculé en accumulant les valeurs successives des variables $tab_ 
prix[$i] (repère ©). 

• Sir utilisateur clique sur le bouton Enregistrer, le script enregistre dans un fichier texte 
toutes les données saisies en parcourant de la même façon les tableaux $tab_code, 
$tab_article et $tab_prix (repère ®). 

Le script se termine en réinitialisant la variable $_POST["envoi "] de façon qu'elle ne 
conserve pas sa dernière valeur (repère ©). 

La figure 12-5 illustre une page de saisie des articles et la figure 12-6 l'ensemble des 
données d'une commande. 

Exemple 12-5. Commande en ligne 

<?php 

session_start( ) ; 
//AJOUTER 

if($_POST["envoi"]=-"AJOUTER" && $_POST["code"] !="" && 

*»-$_POST["article"]! = "" && $_POST["prix"]! = "") 

{ 

$cocle=$_POST["code"]; 

$article= $_POST["article"] ; <-© 

$prix= $_POST["prix"]: <— © 

$_SESSION['code']= $_SESSI0N['code'].'7/".$code; <-© 
$_SESSION['article']= $_SESSION['article']."//".$article: <-© 
$_SESSION['prix']= $_SESSION[ ' prix' ]."//". $prix; ^0 

} 

//VERIFIER 

if($_POST["envor]=-"VERIFIER") 
{ 

echo "<table border=\"l\" >"; 

echo "<tr><td colspan=\''3\"><b>Récapitulatif de votre commande</b></td>" ; 
echo "<tr><th> code </th><th> article </ th><th>  
^prix </th>" ; 
$total=0; 

$tab_code=explode("//".$_SESSION['code']): <-© 
$tab_article=explode("//",$_SESSION ['article']); <-© 
$tab_prix=explode(''//".$_SESSION['prix']) : <-0 
for($i=l;$i<count($tab_code);$i++) <— © 
{ 

echo ''<tr> <td>{$tab_code[$i ] )</td> <td>{$tab_article[$i]}</td><td> 
'•".sprintf("Z01.2f", $tab_prix[$i ] ) . "</td>'' : 
$prixtotal+=$tab_prix[$i ] ; <— © 

) 

echo "<tr> <td colspan=2> PRIX TOTAL </td> <td>".sprintf("%01.2f", Sprixtotal ) . " 

^</td>''; 

echo "</table>"; 

} 

//ENREGISTRER 

if($_POST["envoi'']==''ENREGISTRER") 
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{ 

$idfile=fopen("commande.txt" ,w) ; 

// 

$tab_code=expl ode( "//" ,$_SESSION[ 'code' ] ) ; 
$tab_article=explode("//",$_SESSION[ 'article']) : 
$tab_prix=explode("//",$_SESSION['prix']) : 

for($i=0:$i<coLint($tab_code) ;$i-H-) <— 0 
{ 

fwrite($idfile, $tab_code[$i ] . " ; " . $tab_arti cl e[$i ] . " ; " . $tab_prix[$i ] . " ; 
'•\n"): 

) 

fclose($idfile) ; 

} 

//LOGOUT 

i f( $_POST[ "envoi " ]==" LOGOUT" ) 
{ 

session_unset( ) ; <— 

session_destroy( ) ; <— © 

echo "<h3>La session est terminée</h3>" ; 

} 

$_POST[ "envoi "] = ""; <-© 
?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<htm1 xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r'> 

<title>Gestion de panier</title> 

</head> 

<body> 

<form action="<?php $_SERVER[ ' PHP_SELF' ] ?>" method="post" 
^enctype="appl ication/x-www-form-url encoded"> 
<fieldset> 

<1 egend><b>Sai sies d' articl es</b></l egend> 

<table> 

<tbody> 

<tr> 

<th>code : </th> 

<td> <input type="text" name="code" /></td> 

</tr> 

<tr> 

<th>article : </th> 

<td><input type="text" name="article" /></td> 

</tr> 

<tr> 

<th>prix :</th> 

<td><input type="text" name="prix" /></td> 

</tr> 

<tr> 

<td colspan="3"> 
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<input type="subniit" name="envoi" val ue="AJOUTER" /> 

<input type="subinit" name="envoi" value="VERIFIER" /> 

<input type="subinit" name="envoi" value="ENREGISTRER" /> 

<input type="subinit" name="envoi" value="LOGOUT" /> 

</td> 

</tr> 

</tbody> 

</table> 

</fielclset> 

</form> 

</body> 

</html> 
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Pour un site réel en production, il est bon d'ajouter au formulaire un quatrième bouton, 
nommé Déconnexion, ou Logout, permettant à l'internaute de terminer la session et de 
faire disparaître les données saisies, en particulier son code d'accès. Cette précaution 
n'est pas inutile, surtout si le poste client est utilisé successivement par plusieurs personnes 
et c'est ce que nous avons mis en place dans le code de l'exemple. 

Pour détruire toutes les variables de la session, vous utilisez la fonction session„unset( ) 
(repère ©) sans paramètre et qui ne retourne aucune valeur. Pour terminer la session. 
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vous disposez de la fonction session_destroy( ) (repère ©) également appelée sans para- 
mètre, qui retourne une valeur booléenne TRUE si l'opération est réalisée et FALSE dans le 
cas contraire. 

Pour créer le bouton Submit, il vous resterait à ajouter le code HTML suivant : 

I <input type="subinit" name="envoi" val ue="LOGOUT" /> 

puis, dans le script PHP, le code correspondant suivant : 

if($_POST["envoi"]=="LOGOUT") 
{ 

session_unset( ) ; 
session_clestroy( ) ; 

echo "<h3>La session est terminée</h3>" ; 

} 

Si l'utilisateur clique sur le bouton "LOGOUT", personne ne peut plus afficher sa 
commande, lui y compris. 



Les sessions sans cookie 

Si vous désactivez les cookies dans votre navigateur — dans Firefox, par exemple, via 
Outils, Options, Cookies — et que vous tentiez de tester les exemples 12-4 et 12-5, vous 
constateriez qu'ils ne fonctionnent pas. PHP ne peut plus enregistrer l'identifiant de 
session dans un cookie sur le poste client. Il vous faut donc transmettre cet identifiant 
entre toutes les pages du site d'une autre façon. 

Le nom de la session, par défaut PHPSESSID, et l'identifiant aléatoire de session sont main- 
tenant contenus dans la constante nommée SID, sous la forme : 

I PHPSESSID^ uscbk53ualdiv44kbvp8v5cnq6 

La transmission du nom et de la valeur de l'identifiant se fait en ajoutant à la fin de 
chaque adresse définie dans un lien le caractère ? suivi de la valeur de la constante SID. 

Pour la page pageindex.php, par exemple, il vous faudrait réécrire la liste des liens de la 
manière suivante : 

<p> Visiter les pages du site <br /> 
<ul> 

<li><a href="pagehtml2.php?<?php echo SID?>">Page XHTML </a><?php ifCisset 
^($_SESSION['htmT])) echo " vue ". $_SESSION[ ' html' ] . " fois"; ?> </li> 
<li><a href="pagephp2.php?<?php echo SID?>">Page PHP 5</a><?php ifdsset 
^($_SESSION['php'])) echo " vue ". $_SESSION['php']." fois"; ?> </li> 
</ul> 

et faire de même avec les autres pages du site pour chaque lien. 

Le nom de la session est récupérable en appelant la fonction sessi on_name( ) sans paramè- 
tre et l'identifiant de session en appelant la fonction session_id( ), qui retourne une 
chaîne de caractères. 
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L'usage de la constante SID est de loin préférable pour transmettre l'identifiant vers 
d'autres pages. 

L'envoi de mails 

Vous avez déjà vu au chapitre 6, consacré aux formulaires, la possibilité de communica- 
tion par e-mail entre un internaute et un site Web pour transmettre les données d'un 
formulaire. 

Vous allez découvrir ici la possibilité d'envoyer des e-mails du serveur vers le poste 
client. Pour peu que votre serveur vous l'autorise, cette fonctionnalité vous permet 
d'envoyer un e-mail contenant un identifiant et un code d'accès à une personne qui 
s'inscrit sur un forum de discussion ou un site en donnant son adresse e-mail. Ce contrôle 
évite, par exemple, les saisies fantaisistes ou, pire, les usurpations d'adresse e-mail. 

Sur un site de commerce en ligne, cette fonction donne la possibilité d'envoyer automa- 
tiquement une confirmation de commande sitôt qu'elle est passée. 

La fonction mail() 

La première chose à faire est bien entendu de vous assurer auprès de votre hébergeur que 
vous disposez de la fonction mai 1 ( ). De nombreux hébergeurs, en particulier les gratuits, 
désactivent la fonction d'envoi d'e-mail pour éviter le Spam et surtout pour ne pas 
surcharger leurs serveurs. Certains autres réécrivent la fonction mai 1 ( ) pour en limiter les 
possibilités, le nombre d'envois par exemple. 

Cette vérification peut être réalisée en utilisant l'exemple 7-1 du chapitre 7 (fichier 
fonctionl .php), qui affiche la liste des fonctions disponibles sur le serveur. Pour l'héber- 
gement d'un site professionnel, la possibilité d'envoi d'e-mail peut être un critère de 
sélection déterminant. 

La fonction de base d'envoi d'e-mail se nomme donc mai 1 ( ). Sa syntaxe est la suivante : 
I boolean mail($dest, $objet, $texte, [$entete]) 
Ses paramètres sont les suivants : 

• Sdest est une chaîne contenant l'adresse e-mail du destinataire. Pour envoyer le même 
e-mail à plusieurs adresses, il faut séparer chacune d'elles par une virgule. 

• $objet est une chaîne contenant le texte qui apparaît dans la colonne Objet du logiciel 
de courrier du destinataire. 

• $texte est une chaîne donnant le contenu réel du message, qui peut être au format texte 
ou au format HTML. 

• $entete est une chaîne contenant les en-têtes nécessaires à l'envoi d'e-mails, lorsque 
ces derniers ne sont pas au format texte. Chaque en-tête se termine par la séquence 
"\n" sur un serveur Linux et "\r\n" sous Windows. 
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La fonction mail () retourne la valeur booléenne TRUE si le message est expédié et FALSE 
dans le cas contraire. La vérification que vous pouvez opérer grâce à cette valeur de 
retour ne signifie pas que l'e-mail est bien reçu et ne présage en rien de problèmes tels 
qu'une erreur dans l'adresse ou une adresse inexistante. Dans ces derniers cas, vous rece- 
vez un message d'erreur à l'adresse de l'expéditeur (sauf spécification contraire) dans un 
délai qui peut aller de quelques minutes à plusieurs jours. 



Envoi d'e-mail au format texte 

Votre premier exemple n'utilise que les trois premiers paramètres de la fonction mai 1 ( ). 

A partir d'un formulaire de commande de livres, dans lequel le client saisit sa commande 
sous la forme d'un nom d'article (repère O), d'une quantité (repère©), de son nom 
(repère ©) et de son adresse postale (repère O) ^t enfin de son e-mail (repère 0), le 
script lui envoie un e-mail de confirmation récapitulant la commande. 

Le script contient la définition d'un tableau contenant le tarif de chaque livre (repère 0). 
Il ne contient ici que trois titres. Dans la réalité, le tarif serait bien entendu contenu dans 
la base de données interrogée. Comme vous en avez l'habitude, le script vérifie ensuite 
l'existence des variables envoyées par le formulaire (repère Q) puis recherche le prix de 
l'article commandé (repère 0) et crée le contenu du message dans la variable $text en 
concaténant les différentes informations envoyées par le client (repère 0). 

L'e-mail de confirmation est alors envoyé (repère ®), et une vérification est opérée pour 
savoir si l'opération s'est bien déroulée et afficher un avis au client. 

La figure 12-7 illustre la page de commande de livres. 
'•^ Exemple 12-6 Envoi d'un e-mail de confirmation 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 
<style type="text/css"> 

td {background-color:yellow;color:blue;font-family: arlal. helvetica, sans-serif; 

^font-slze: 12pt:font-weight: bold;} 

</style> 

<title>Votre commande</titl e> 

</head> 

<body> 

<div><h3>Art1cles </h3> "XHTML et CSS" : 29.90 n<br />"PHP 5" : 29.50 n<br /> 

'•"MySQL" : 19.75 n<br /Xbr /></div> 

<form action="<?= $_SERVER[ ' PHP_SELF' ] ?> " method="post" 

enctype="appl i cation/x-www-form-url encoded" > 

<fieldset> 

<1 egend>Passez votre commande</legend> 
<table border="0" > 

<tr> 



<td>Article</td> 

<td><input type="text" nante="arti cl e" size="40" niaxlength="256" /></td><— © 
</tr> 
<tr> 

<td>Quantité</td> 

<td><input type="text" name="quantite" size="40" /></td> <— 0 
</tr> 
<tr> 

<td>Noni</td> 

<td><input type="text" name="noin" size="40" maxl ength="256" /></td><— 0 
</tr> 
<tr> 

<td>Adresse</td> 

<td><input type="text" name="adresse" size="40" maxlength="256" /></td><— © 
</tr> 
<tr> 

<td>Mail</td> 

<td><input type="text" name="niail " size="40" maxl ength="256" /X/tdX—Q 
</tr> 
<tr > 

<td col span="2">  <input type="subniit" naine="envoi "val ue=" Commander 
^ /></td> 
</tr> 
</table> 
</fieldset> 
</forin> 

<!— SCRIPT PHP — > 
<?php 

//Création du tarif des livres 

$tarif= arrayC'XHTML et CSS"=>29.90, "PHP 5"=>29.50, "MySQL"=>19.75) ; <-© 

//Gestion de la commande 

if(isset{$_POST['article'])&& isset($_POST['quantite']) && isset($_POST['nom']) 
isset($_POST['adresse']) && isset($_POST['niair]) )<-© 

{ 

$article=$_POST[' article']; 
$prix= $tarif [$article] : <— 0 
$objet="Confirmation de commande"; 
//Contenu du mail 
$text.= "Nous avons bien reçu votre commande de : \n"; 
$text.="{$_POST[ 'quantité']} livres "; 

$text.= $_POST['article'] . " au prix unitaire de : ". $prix ." euros \n"; 

$text.= "Soit un prix total de : ". $prix * $_POST[ 'quantité' ] ." euros \n"; 

$text.="Adresse de livraison : \n". $_POST[ 'nom' ] . " \n"; 

$text.=$_POST['adresse']. " \n"; 

$text . = " Cordialement" ; <—0 
if{mail($_POST['mail '].$objet.$text)) <— © 
{ 

echo "<hl>Vous allez recevoir un mail de confirmation </ hl>"; 

} 

else 
{ 
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echo "<hl>Le mail n'a pas été envoyé: recommencez! </hl>"; 

} 

} 

?> 

</body> 
</html> 



3 Votre commande - Microsoft Internet Explorer |^f5~ | fx" | 



Fichier Edition Affichage Favoris Outils ? /' 
Q Précédente ' 1^ " [?] ^ ^Rechercher ^Favoris 



Passez votre commande 



Article 


PHP5 1 


Quantité 


3 1 


Nom 


lAnatole RICOD | 


Adresse 


21 rue Compoint 7501 8 PARIS | 


Mail 


aricod@tiscali.fr | 



I Commander | 



^ Terminé 9 Internet 

Figure 12-7 

Bon de commande de livres 



La figure 12-8 illustre l'e-mail tel qu'il peut être visualisé par le client du site dans 
Outlook Express. 



De: webmaster® " - À: . 's@ ^ 
Objet : Confirmation de commande 



Nous avons bien reçu votre commande de : 
3 livres PHP5 au prix unitaire de : 29 euros 
Soit un prix total de : 87 euros 
Adresse de livraison ; 
Anatole RICOD 
21 rue Compoint 75018 PARIS 
Cordialement 



Figure 12-8 

E-mail reçu par le client 

En utilisant le quatrième paramètre de la fonction mai 1 ( ), il est possible pour des applica- 
tions particulières de mettre en copie simple d'autres destinataires (option Ce dans 
Outlook Express : les destinataires voient l'adresse de tous les autres) ou en copie cachée 
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(option Cci : les destinataires ne voient pas l'adresse des autres). Ce paramètre permet 
d'ajouter des en-têtes dans l'e-mail et de définir leur valeur. 

Le tableau 12-1 récapitule l'ensemble des en-têtes utilisables dans l'envoi des mails. 



Tableau 12-1 - En-têtes utilisables au format texte ou HTIVIL 



En tête 


Définition 


From: 


Adresse de l'expéditeur de l'e-mail si vous souliaitez qu'elle soit différente de celle qui est écrite 
dans le corps du message. 


ce: 


Adresse e-mail du destinataire en copie. S'il y en a plusieurs, elles doivent être séparées par des 
virgules. 


bec: 


Adresse du destinataire en copie cacfiée 


Reply-To: 


Adresse à laquelle parviendra la réponse éventuelle du destinataire s'il rédige son e-mall en utilisant 
le bouton Répondre. 


X-Mailer: 


Nom du logiciel d'envoi du courrier 


Date: 


Date de l'e-mail au format JJ MM AAAA h:m:s -i-ONOO, dans laquelle N est le décalage horaire. 



En utilisant ces en-têtes dans le quatrième paramètre de la fonction mai 1 ( ), le code défi- 
nissant le contenu de l'e-mail de l'exemple précédent devient : 

$text.= "Nous avons bien reçu votre commande de : \n"; 
$text.="{$_POST['quantite']) livres "; 

$text.= $_POST['article'] . " au prix unitaire de : ". Sprix ." euros \n"; 

$text.= "Soit un prix total de : ". Sprix * $_POST[ 'quantité' ] ." euros \n"; 

$text.="Adresse de livraison : \n". $_POST[ 'nom' ] . " \n"; 

$text.=$_POST['adresse']. " \n": 

$text .=" Cordialement"; 

//Ecriture des en-tetes 

$entete=" From: ventes@machin.com" ; 

$entete="cc:compta@machin .com" ; 

$entete.="bcc: jul ia@machin.com" ; 

$entete.="Reply-To: reponse@machin .com" ; 

$entete.="X-Mail er : PHP" .phpversionC ) ; 

$entete.="Date:".date("D, j M Y H:i:s -fOIOO") ; 
i f ( mai 1 ( $_POST[ 'mail'], $ob j et . $text , Sentete ) ) 

{echo "<hl>Le mail a été envoyé </ hl>";} 
el se 

{ echo "<hl>Le mail n'a pas été envoyé </hl>"; } 



Envoi d'e-mail au format HTIVIL 



L'envoi d'e-mail au format HTML permet de rendre l'aspect visuel du message beau- 
coup plus agréable car il se présente comme une page HTML, avec tout ce qu'elle peut 
comporter, comme des titres, des image ou des liens. 
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Cette méthode est évidemment recommandée pour l'envoi d'e-mails publicitaires ou 
d'information à une liste de personnes inscrites à une liste de distribution (mailing list). 

Pour réaliser ce type d'e-mail, vous utilisez encore le quatrième paramètre de la fonction 
mai 1 ( ) en ajoutant cette fois les en-têtes MIME détaillés au tableau 12-2. Chaque en-tête 
se termine par la séquence "\n". 

En-tête MiiVIE 

Les types MIME {Multipurpose Internet Mail Extensions) ont été créés pour permettre d'insérer des docu- 
ments (images, sons, texte HTML, etc.) dans un courrier. 

Pour incorporer des images dans un e-mail au format HTML, vous écrivez le code 
HTML de la même façon que pour une page Web classique mais en veillant que l'attribut 
liref de l'élément <img> contienne l'adresse absolue des images employées. Si cette 
méthode présente l'inconvénient d'obliger le destinataire à être en ligne pour pouvoir 
visualiser les images, elle rend en contrepartie les messages moins lourds. 



Tableau 12-2 - En-têtes IVIIME 


En tête 


Définition 


MIME-Version: 


Indique que le contenu de l'e-mail est conforme aux spécifications MIME ainsi que la 
version utilisée (actuellement 1.0 ou 1 .1). Cet en-tête doit être écrit le premier : 
MIME-Version: 1.0 


Content-Type: 

1 


Définit le type de contenu de l'e-mail à l'aide d'un type MIME ainsi que le jeu de carac- 
tères à utiliser : 1 
Content-Type: text/Intml ;charset=iso-8859-l | 


Content-Transfer- 
Encoding: 


Définit le mode de codage des documents, en particulier des images liées à l'e-mail. 
Il y a plusieurs valeurs possibles, mais il est préférable de choisir la valeur 8bit : 
Content-Transfer-Enccding: Bbi t 



L'exemple 12-7 envoie un e-mail d'annonce d'un grand événement à une personne 
(repère O). Il serait bien entendu possible de l'améliorer en créant une boucle qui lirait 
un tableau contenant la liste de tous les destinataires inscrits sur le site qui délivre l'infor- 
mation. 

Le texte de l'e-mail est composé uniquement de code XHTML, contenant un gros titre, 
une image (repère 0) et deux liens hypertextes (repères Q et Q). Ce contenu pourrait 
être parfaitement affiché dans un navigateur quelconque en tant que page Web. 

Les en-têtes utilisés définissent l'utilisation des spécifications MIME (repère 0), le type 
de contenu de l'e-mail (repère ©), le type d'encodage (repère Q) et l'adresse d'origine 
(repère 0). Ce sont eux qui vont permettre l'affichage du contenu de la variable $text 
comme une page HTML par le logiciel de messagerie. La fonction mai 1 ( ) reçoit ensuite 
ces quatre paramètres, réalise l'envoi de l'e-mail et affiche un message de confirmation 
(repère 0). 
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'•^ Exemple 12-7. Envoi d'e-mail au format HTML 

<?php 

Sdest = "abonne@inachin.coni" ; O 
$objet = "Test mail en HTML"; 
//Contenu HTML du mail 

$texte = "<html><head><title>Envoi de mail HTML</titl e></head> 
<body><hl>La bonne nouvelle du mois</hl> 
<b>Sort1e de PHP 5 version finale!</b> 

<img src=\" http://stat1c.php. net/www. php. net/1 mages/php. g1f\" 
^alt=\"Logo PHP\" /> <-© 

<a href=\"http://www.php.net.\">Plus d'infos 1ci</A><— © 
<p>Télécharger un Installeur pour une utilisation en locaKbr /> 
<a href=\"http://www.phpathome.fr.tc\">Le site PHP@Home</A> •^O 
</body></html>": 

//En têtes indispensables pour un mail en HTML 
$entete="MIME-Vers1on: 1.0"; <-© 

$entete .= "Content-Type:text/html ;charset=iso-8859-l\n" ; <— © 
$entete .= "Content-Transfer-Encoding: 8b1t\n";<— © 
$entete .= "From: engels@funhtml.com \n":<— 0 
//Envol du mail 

if (mail($dest,$objet.$texte.$entete)) <— 0 
{ 

print "Le mail a été envoyé<br> <br />"; 

} 

el se 
{ 

print "le mail n'a pas été envoyé<br />"; 

} 

?> 



De : webmaster^Funptip.com A : '@funphp.con) 
Objet: Test mal en HTML 

La bonne nouvelle du mois 

Sarde de PHP 5 version finale! ^^^^^^^^ Plus d'infos ici 

TftlprViargpr un in-îtallpiir pour imp uttli dation wi lonal 
Le nte FSP&Horae 



Figure 12-9 

E-mail en XHTML reçu dans Outlook 



Mémo des fonctions 
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boolean setcookie(string $nom,string $valeur,int Sdate.string chemin, string domaine, int 
sécurité) 

Écrit le cookie nommé $nom dont le contenu est $val eur et la date d'expiration $date. Les paramètres suivants indiquent 
le chemin et le nom du domaine qui peut accéder au cookie et s'il doit être accessible par une connexion sécurisée 
(valeur 1). 

boolean mail (string $dest, string $cbjet, string $text, string $entete) 

Envoie l'e-mail dont le destinataire, l'objet et le texte sont précisés. Les en-têtes permettent d'envoyer des e-mails au 
format HTML. 

boolean session_start( ) 

Démarre une session. 

boolean session_destroy( ) 

Détruit la session en cours. 

void session_unset( ) 

Détruit toutes les variables de session. 

string session_name([string $nom]) 

Sans paramètre, la fonction retourne le nom de la session. Avec un paramètre, elle définit un nouveau nom de session, 
string session_id([string $id]) 

Sans paramètre, la fonction retourne l'identifiant de la session. Avec un paramètre, elle définit une nouvelle valeur pour 
l'identifiant. 

string session_save_patfi( [string $id]) 

Sans paramètre, la fonction retourne le cfiemin d'accès au dossier qui stocke les données de la session. Avec un para- 
mètre, elle définit un nouveau dossier de stockage. 

void session_write_close( ) 

Écrit les variables de la session sur le serveur et ferme la session. 



Exercices 

Exercice 1 

Créez un formulaire de saisie des deux codes couleur préférés du visiteur du site pour la 
couleur de fond et le texte de la page. Enregistrez-les dans deux cookies valables deux 
mois. A l'ouverture de la page d'accueil, récupérez ces valeurs, et créez un style utilisant 
ces données. 

Exercice 2 

Même exercice, mais en stockant les deux informations dans un même cookie. 



368 



PHP 5 



Exercice 3 

Après avoir créé un formulaire de saisie du nom et du mot de passe du visiteur ainsi que 
d'une durée de validité puis avoir autorisé l'accès au site, enregistrez un cookie contenant 
ces informations. Lors de la connexion suivante, le formulaire devra contenir ces infor- 
mations dès l'affichage de la page. 

Exercice 4 

Enregistrez le nom de la page du site préférée du visiteur dans un cookie. Lors de sa 
connexion, il devra être redirigé automatiquement vers cette page. 

Exercice 5 

Envoyez un ensemble d'e-mails ayant tous le même objet et le même contenu à partir 
d'une liste d'adresses contenue dans un tableau. 

Exercice 6 

Même exercice, mais cette fois chaque objet et chaque contenu des e-mails doit être 
différent et extrait d'un tableau multidimensionnel. 

Exercice 7 

Reprenez l'exercice 1 en enregistrant les préférences du visiteur dans des variables de 
session pour afficher toutes les pages du site avec ses couleurs préférées. 

Exercice 8 

Transformez le script de l'exemple 12-5 (commande en ligne) en permettant les saisies à 
partir de pages différentes et en créant sur chacune un bouton provoquant l'affichage de 
l'ensemble du panier à chaque demande. 
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Une base de données est un ensemble d'informations stockées sur un support et doté 
d'une certaine organisation. Votre carnet d'adresses en est un exemple élémentaire, 
l'annuaire du téléphone également, mais à une autre échelle. 

L'accès rapide à l'information via des réseaux comme ceux des entreprises puis par 
Internet a nécessité la création de systèmes d'organisation des données permettant un 
accès rapide à l'information. Imaginez que vous deviez trouver toutes les personnes 
portant le même nom dans un département donné. La consultation de l'annuaire vous 
prendrait des heures. Face à de tels problèmes, l'informatisation du stockage des données 
est devenue une nécessité. C'est dans ce but qu'ont été créés les SGBDR (Système de 
gestion de base de données relationnelle). 

L'objectif de ce chapitre n'est pas de vous fournir un cours complet sur les bases de 
données, loin de là. Il s'agit simplement de rappeler les notions essentielles qui vous 
permettront, à partir d'un besoin particulier de stockage d'information, de structurer les 
différentes données dans une base. Pour approfondir le sujet de la conception des bases 
de données et en particulier la méthode de conception UML (Unified Modeling 
Language, Langage de modélisation unifié en français), mieux adaptée à la conception 
orientée objet, vous pouvez vous reporter utilement à l'ouvrage de Christian Soutou, 
De UML à SQL : Conception de bases de données, paru aux éditions Eyrolles. 

L'organisation des données doit permettre de répondre à des contraintes précises, notam- 
ment les suivantes : 

• Les données doivent occuper le moins d'espace possible. 

• Les redondances d'information doivent être évitées. 
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• Les mises à jour ou la suppression de données doivent laisser la base intègre et ne pas 
créer d'incohérences. 

• La recherche d'informations doit être rapide et sûre. 
Vous allez donc aborder successivement les phases suivantes : 

1. Élaboration du modèle d'organisation des données à l'aide de la méthode entité/asso- 
ciation. Cela entraîne la création d'un modèle conceptuel de données (MCD), qui est 
une représentation abstraite des données à stocker et des liens entre elles. 

2. Passage du modèle ainsi créé au modèle relationnel, qui est actuellement le plus 
courant. Cela entraîne la création d'un modèle logique de données (MLD), qui est la 
représentation d'un modèle implantable dans un système particulier. 

3. Implémentation dans un SGBDR (Système de gestion de base de données relation- 
nelle) particulier, comme MySQL ou SQLite, qui font l'objet des chapitres suivants. 

L'exemple qui servira de socle à tout ce chapitre est la modélisation de la base de données 
nécessaire à la gestion d'un site de commerce en ligne. 

Le modèle entité/association 

Le nom anglais du modèle entité/association (Endty/Relationship) est à l'origine de la 
confusion que l'on retrouve souvent dans la définition d'une base de données relation- 
nelle (BDR). Certains auteurs définissent un BDR comme une base ayant des relations 
entre tables. Or une base est dite relationnelle si elle repose sur la notion de table, qui est 
la traduction du concept mathématique de relation entre ensembles. Une base de données 
peut en effet être qualifiée de relationnelle et ne comporter qu'une seule table. 

Le modèle entité/association permet la modélisation abstraite d'une base de données. 
Il utilise un ensemble de conventions de représentation graphique pour modéliser les 
différents concepts contenus dans une information et les liens qui existent entre eux. 
Les schémas réalisés sont similaires à ceux de la méthode Merise et donc différents de 
la notation UML. 

Les entités 

On appelle entité une représentation d'un ensemble d'objets réels ou abstraits qui ont 
des caractéristiques communes. Une information du monde réel peut correspondre à 
plusieurs entités. Cette décomposition de l'information en plusieurs entités, dont chacune 
a une nature différente, constitue la première étape du travail de conception. Si vous 
voulez modéliser une commande faite par un client, il apparaît en première lecture au 
moins deux entités, une personne d'un côté et les articles qu'elles commande de l'autre. 
Vous avez bien fait apparaître deux entités de nature différente. Chaque personne réelle 
est une occurrence de l'entité générale personne. 
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On distingue deux sortes d'entités : 

• Les entités fortes, qui ne dépendent pas de l'existence d'une autre entité. C'est le cas, 
par exemple, d'une entité représentant un personne ou un produit. 

• Les entités faibles, dont l'existence dépend d'une autre entité. C'est le cas d'une entité 
représentant une commande qui dépend de l'entité personne (pas de commande s'il n'y 
a pas de client). 

Les entités sont représentées graphiquement par des rectangles (voir figure 13-1). 



personne 



Figure 13-1 

Représentation des entités 



voiture 



facture 



livre 



Les attributs 

Chaque entité a des caractéristiques particulières, que l'on retrouve dans toutes ses 
occurrences. Un client a, par exemple, nécessairement un nom, un prénom, une adresse, 
etc. Ces caractéristiques sont nommées attributs de l'entité. 

Chaque entité doit avoir au moins un attribut, qui permet de distinguer une occurrence 
d'une autre. Cet attribut particulier est la clé primaire de l'entité. Cette clé doit être 
unique dans l'entité. Pour une personne, il est évidemment possible de trouver deux 
personnes de même nom. Le nom est donc un mauvais candidat pour effectuer cette 
distinction. 

Pour distinguer deux clients, on utilise habituellement un numéro de client pour chaque 
personne. La clé primaire peut être constituée de la réunion de plusieurs attributs, par 
exemple, le nom et l'adresse, si nous admettons qu'il n'est pas possible que deux personnes 
homonymes habitent au même endroit. L'utilisation d'une clé primaire abstraite, comme 
un identifiant numérique (par exemple le numéro INSEE propre à chaque personne), 
représente une solution plus sûre que le choix d'un autre attribut, et il est conseillé de 
l'utiliser systématiquement. 

Un attribut peut être défini comme obligatoire ou facultatif dans l'entité. Il peut être 
élémentaire ou décomposable en plusieurs autres attributs. L'adresse complète d'une 
personne peut constituer un seul attribut ou être décomposée en rue, ville, département 
et code postal. Il n'y a pas d'obligation en ce domaine. Cela relève d'un choix du pro- 
grammeur en fonction des besoins du client. S'il n'envisage pas de réaliser un jour des 
recherches de personnes par ville ou par département, il est inutile de décomposer l'attri- 
but adresse. 

Chaque attribut possède un domaine de valeurs possibles. Un nom est représenté par une 
chaîne de caractères de longueur variable et le code postal par un nombre de cinq chiffres. 
A chaque attribut correspond un type de donnée particulier. C'est à prendre en compte 
lors de l'implantation de la base de données sur un SGBDR particulier. 
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Une entité munie de ses attributs est représentée par un rectangle contenant le nom de 
l'entité suivi de celui de ses attributs. Dans la représentation graphique de l'entité, le nom 
de l'attribut qui constitue la clé primaire est placé en premier et souligné (voir figure 13-2). 



personne 

id personne 
nom 
prénom 
adresse 
ville 



Figure 13-2 

Représentation graphique d'une entité 

Les associations 

Le concept d'association permet de représenter le lien existant entre deux ou plusieurs 
entités. Une association reliant deux entités est dite binaire. Celle qui en relie plusieurs 
est dite n-aire. Dans la décomposition de l'information en entités vous avez toujours inté- 
rêt à créer des associations binaires et à redécomposer celles qui seraient ternaires. 

Une association est généralement nommée à l'aide d'un verbe d'action (à la forme active 
d'une entité vers l'autre et passive dans l'autre sens). Par exemple, la phrase « Un client 
commande un article » résume l'association commande entre l'entité cl lent et vers l'entité 
article. Une association est représentée graphiquement par une ellipse contenant son 
nom. La figure 13-3 donne la représentation graphique de cette association. Une associa- 
tion peut, comme les entités, posséder des attributs. La clé de l'association est la conca- 
ténation des clés des entités qu'elle relie. Une association peut être réflexive, c'est-à-dire 
relier une entité à elle-même. Par exemple, l'association conjoi nt relie une personne avec 
une autre personne. 



personne 




article 


id personne 
nom 
prénom 
adresse 
ville 


commande \^ 


id article 
désignation 
prix 




\. date y 



Figure 13-3 

Représentation d'une association binaire 

Les cardinaiités 

La cardinalité d'une association mesure le nombre d'occurrences d'une entité qu'il est 
possible d'associer à une occurrence de l'autre entité associée. Elles sont indiquées de 
chaque coté de l'association pour chaque entité. 
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On distingue des cardinalités minimales et maximales : 

• La cardinalité minimale mesure le nombre minimal de participation d'une entité dans 
l'association. Pour être enregistrée dans la base, une personne doit passer au moins 
une commande. La cardinalité minimale du coté de l'entité personne est donc 1. Un 
produit peut n'être commandé par aucune personne. La cardinalité minimale du coté 
de l'entité arti cl e est donc 0. En résumé, on indique ces deux cardinalités par la nota- 
tion O.N. 

• La cardinalité maximale mesure le nombre maximal de participations d'une entité 
dans l'association. Une personne peut passer un nombre quelconque de commandes. 
La cardinalité maximale du coté de l'entité personne est donc notée N. Un produit peut 
être commandée par personnes différentes. La cardinalité maximale du coté de 
l'entité a rti cl e est donc N. En résumé, on indique ces deux cardinalités par la notation 
N.N. En pratique, on la note N.M pour montrer que les cardinalités ne sont pas néces- 
sairement égales. 

Par combinaison des différentes possibilités, on obtient quatre cardinalités possibles pour 
chaque entité : 

• 0.1: zéro ou une seule au maximum ; 

• 1.1: une et une seule ; 

• O.N : zéro ou plusieurs ; 

• l.N : une ou plusieurs. 

• La figure 13-4 représente l'association commande munie de ses cardinalités. 



personne 




article 


Id personne 
nom 
prénom 
adresse 
ville 


/ commande \ 
1.N r 1 O.N 


Id article 
désignation 
prix 


date y 



Figure 13-4 

Association et cardinalités 



Une association peut être définie au moyen des seules cardinalités maximales. L'associa- 
tion de la figure 13-4 peut être définie par la cardinalité N:M. 

Après étude des cardinalités, on distingue plusieurs cas, qui vont constituer l'organisation 
des tables dans le modèle relationnel. 

Détermination des cardinalités 

Vous verrez dans les exemples qui suivent que la détermination des cardinalités peut 
dépendre des contraintes imposées au programmeur. 
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Exemple 1 

Un ministère comprend plusieurs services. Chaque service est dirigé par une seule 
personne. Pour tenir compte des changements de directeur, l'association di ri ge doit avoir 
un attribut date qui contienne la date de nomination. La figure 13-5 donne une représen- 
tation de cette association. 



dirigeant 


1.1 




1.1 


service 


id personne 
nompers 


f dirige \ 
V date y 


id serv 






nomserv 



Figure 13-5 

Association 1:1 



Une et une seule personne dirige un service, ce qui correspond à une cardinalité 1.1 pour 
l'entité dirigeant. Chaque service est dirigé par une et une seule personne, ce qui se 
traduit par une cardinalité 1.1 pour l'entité service. 

Exemple 2 

Reprenons le même ministère qu'à l'exemple 1 mais en représentant l'association entre 
tous les employés du ministère, quel que soit leur grade ou le service dans lequel ils 
travaillent. Une personne travaille dans un et un seul service. La cardinalité du côté de 
l'entité personne est donc 1.1. Un service emploie de une personne à plusieurs personnes. 
La cardinalité du côté de l'entité service est donc l.N. 

La figure 13-6 donne une représentation de cette association. 



personne 

id_personne 
nompers 
date 



Figure 13-6 

Association 1:N 




l.N 


service 


id serv 
nomserv 





Exemple 3 

Pour suivre l'évolution des prix, on recense un nombre de produits vendus dans un 
ensemble de magasins. Chaque magasin peut vendre un ou plusieurs produits. La cardi- 
nalité du coté de l'entité magasin est donc l.N. Chaque produit peut être vendu par un ou 
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plusieurs magasins. La cardinalité du coté de l'entité produit est donc l.N. Chaque maga- 
sin vend le produit à un prix donné. L'association doit donc posséder un attribut prix. 

La figure 13-7 donne une représentation de cette association. 



magasin 




produit 


id_magasin 


1.N ^''''"'^^«^^^^^N 1.N 


id_p réduit 


nom 
ville 




nom 


V prix J 



Figure 13-7 

Association N.M 

Conception du MCD 

Pour établir le modèle conceptuel de données (MCD) correspondant à l'ensemble 
d'informations à stocker, il faut procéder de la façon suivante : 

1. Décomposer l'information globale en entités indépendantes représentant des concepts 
différents. 

2. Pour chaque entité, faire l'inventaire des attributs qui permettent de la décrire. Le 
degré de précision de cette description dépend des besoins du client et de l'utilisation 
qui sera faite de la base de données. Chaque attribut doit être utile. Il faut, par exemple, 
envisager quels seront les critères de recherche utilisés sur la base. Chaque attribut 
doit pouvoir être exprimé clairement par une chaîne de caractères, un nombre ou une 
date, par exemple. 

3. Pour chaque entité, choisir l'attribut ou le groupe d'attributs qui peut constituer une 
clé primaire, en évitant les clés primaires composites dans la mesure du possible. 
L'utilisation d'une clé primaire numérique est souvent la meilleure solution. 

4. Définir les associations qui relient les différentes entités. Il faut privilégier les associa- 
tions binaires, quitte à créer des entités supplémentaires. La gestion et l'interrogation 
de la base s'en trouvent facilitées. 

5. Déterminer les attributs de l'association en ne retenant que les attributs vraiment 
nécessaires caractérisant l'association. Si un attribut n'est pas nécessaire, mieux vaut 
le placer dans une entité. 

6. Exprimer les cardinalités de l'association pour chaque entité qui y est reliée. 

Normalisation du MCD 

Le MCD élaboré à l'étape précédente doit être vérifié et normalisé au moyen de méthodes 
particulières. 
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Il faut introduire ici la notion de dépendance fonctionnelle (DF), proche de la notion 
mathématique de fonction. On dit que deux attributs A et B sont en dépendance fonction- 
nelle si, à une valeur de A, correspond, au plus, une valeur de B. 

On a, par exemple, les dépendances fonctionnelles suivantes : 

Inuméro_client Nom_client 
commune — > code postal 

alors que les réciproques ne sont pas vraies. 

Les méthodes permettant de vérifier et de normaliser le MCD sont les suivantes : 

• Chaque attribut est atomique, c'est-à-dire qu'il ne peut contenir qu'une seule valeur 
choisie dans un domaine particulier. Par exemple, un attribut ne peut contenir 
plusieurs noms de personnes différentes. C'est ce qu'on nomme la première forme 
normale (1 N.F) 

• Tous les attributs d'une entité en 1 N.F doivent dépendre complètement de la clé de 
l'entité et non d'une partie seulement de la clé. C'est la deuxième forme normale 
(2 N.F). Une entité en 1 N.F qui a une clé primaire composée d'un seul attribut est 
nécessairement en 2 N.F. 

• Tous les attributs d'une entité en 2 N.F dépendent uniquement de la clé et non d'un 
autre attribut nom-clé. Si ce n'est pas le cas, il faut décomposer l'entité en deux entités 
distinctes, la nouvelle entité contenant les attributs nom-clé qui sont en dépendance 
fonctionnelle. C'est la troisième forme normale (3 N.F). 

• Les attributs d'une association doivent être en 2 N.F et donc dépendre de toute la clé 
de l'association (constituée par la concaténation des clés des entités reliées). 

La base magasin en ligne 

Votre objectif premier étant de modéliser la base de données d'un site de commerce en 
ligne, vous devez envisager les contraintes d'utilisation de la base qui vous permettront 
de créer son MCD : 

1. Un client enregistré dans la base a passé au moins une commande, sinon il ne figure 
pas dans la base. 

2. Une commande peut contenir un ou plusieurs articles. Chaque commande a une date. 

3. Le modèle doit permettre de retrouver toutes les commandes d'un client et la compo- 
sition de chaque commande. 

En fonction de ces contraintes, vous constatez immédiatement que le MCD de la 
figure 13-4 ne convient pas. En effet, il ne prend pas en compte le fait qu'un client peut 
commander plusieurs articles (contrainte n° 2). 

Vous devez créer une entité séparée pour représenter une commande et les associations 
répondant aux besoins suivants : 
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• Un client passe une ou plusieurs commandes. L'association passe relie les entités 
cl ient et commande. Un client passe une ou plusieurs commandes, ce qui implique une 
cardinalité l.N du coté de l'entité cl ient. Une commande est passée par un seul client, 
ce qui implique une cardinalité 1.1 du coté de l'entité commande. 

• Une commande contient un ou plusieurs articles. Vous créez donc une association 
contient, qui relie les entités commande et article. La cardinalité du côté de l'entité 
commande est l.N. Un article pouvant se trouver dans aucune ou plusieurs commandes, la 
cardinalité du coté de l'entité article est O.N. 

Vous obtenez finalement le MCD représenté à la figure 13-8. 



client 




id_c lient 




nom 




prénom 




âge 




adresse 




ville 




mail 






passe 





commande 




id corn m 




date 






contient 





article 




id article 


•)0.N 


design 




prix 




catégorie 



Figure 13-8 

Le MCD de la base magasin 



Passage au modèle relationnel 

La phase précédente vous a permis de créer le MCD de la base. C'est la partie la plus 
importante de votre travail. Il vous faut maintenant créer le modèle logique de données 
(MLD), qui permettra l'implémentation physique de la base sur des SGBDR comme 
MySQL ou SQLite. 

Le modèle relationnel 

La théorie des SGBDR s'appuie sur les notions mathématiques de la théorie des ensembles 
et des relations entre ensembles. A chaque attribut correspond un ensemble de valeurs 
possibles (parfois très grand) nommé domaine. 

Supposez, par exemple, que vous deviez étudier les notes attribuées à une classe de 
26 élèves nommés par des lettres de A à Z et qu'il existe, pour simplifier, quatre catégo- 
ries de notes de 1 à 4. A la rentrée scolaire, où tous les espoirs sont permis, il y a donc 
théoriquement 26 x 4 = 104 associations (couples) possibles entre l'ensemble des élèves 
et celui des notes correspondant au produit cartésien des deux ensembles, soit l'énuméra- 
tion {(A,1),(A,2),(A,3),...(B1,B2),...,(Z,1),(Z,2),(Z,3),(Z,4)}. À la fm de l'année, quand 
les moyennes annuelles sont faites, il n'y a plus que 26 couples réels représentant la 
réalité de la classe. Cette réalité est représentée par une relation entre l'ensemble des 
élèves et celui des notes. Dans le cas présent, à un élève ne correspond qu'une note, mais 
à une note correspondent plusieurs élèves. 
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Chaque relation est représentée par une table. Vous pouvez comparer aisément une table 
à une feuille de tableur que chacun doit connaître. Dans une table, on stocke les informa- 
tions représentatives d'un type particulier d'objet, réel ou abstrait, comme une personne 
ou une commande. Tous les objets représentés dans une même table doivent représenter 
un même concept. 

La représentation des notes de la classe serait donc une table à deux colonnes, chaque 
colonne étant un attribut de la table. La première contient le nom et la seconde la note de 
l'élève. Elle aurait au total vingt-six lignes. 

La figure 13-9 donne une représentation d'une table représentant des articles. La première 
ligne d' en-tête donne le nom de la table, la deuxième contient la liste des attributs, et les 
suivantes contiennent les valeurs de plusieurs occurrences, chacune représentant un tuple 
(ou w-uplet). 



article 


idarticle 


désignation 


prix 


catégorie 


515 


PC de bureau 


958.35 


Informatique 


535 


Appareil photo 


253.58 


Photo 


647 


Portable HB 25 


1547.00 


Informatique 



attributs 



Figure 13-9 

Représentation d'une table 



Conception du MLD 

Pour passer du MCD au MLD, il vous faut appliquer les règles suivantes : 

1. Toute entité devient une table, avec pour corollaires que la table porte le nom de 
l'entité, que les attributs de l'entité deviennent les colonnes de la table et que la clé 
primaire de l'entité devient la clé de la table. 

2. Pour une association binaire ayant des cardinalités maximales 1:1 (par exemple 1.1- 
1.1), une des tables reçoit comme attribut supplémentaire une copie de la clé primaire 
de l'autre table. Cet attribut devient une clé étrangère pour la table qui la reçoit. Les 
attributs éventuels de l'association sont reportés dans cette même table. Au MCD 
présenté à la figure 13-5 correspond le MLD de la figure 13-10 pour l'association 
di rige. 

Si vous voulez par exemple conserver l'historique des différents responsables d'un 
service, vous devez créer une nouvelle table représentant l'association. Elle contient 
les clés des deux entités reliées, et la concaténation des ces clés en constitue la clé 
primaire. Cette table contient également l'attribut de l'association. 
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Figure 13-10 

MLD d'une association 1:1 

3. Pour une association binaire ayant des cardinalités maximales de type 1 :N, par exem- 
ple, 1.1-l.N ou 0.1-O.N, la table représentant l'entité ayant la cardinalité 1.1 reçoit la 
clé de l'autre entité comme clé étrangère. Les attributs de l'association sont ajoutés à 
cette même table. Le MCD de la figure 13-6 devient le MLD présenté à la figure 13-11 
pour les employés d'un service. 



personne 




service 


id personne 
id_serv 
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date 


id serv 
nomserv 





Figure 13-11 

MLD d'une association 1:N 

4. Pour une association binaire ayant des cardinalités maximales de type N:M, par 
exemple, l.N-l.N ou O.N-l.N, l'association est toujours traduite par une table. La clé 
primaire de cette table est la concaténation des clés primaires des entités reliées par 
cette association. Les attributs de l'association sont ajoutés à cette nouvelle table. Le 
MCD de la figure 13-7 correspond au MLD de la figure 13-12. Il s'agit d'un MCD 
primaire, car il suppose qu'une personne ne peut commander qu'un article par 
commande et une seule fois le même article, faute de quoi vous seriez en infraction 
avec les règles définies (à une même clé primaire correspondrait deux dates diffé- 
rentes). 
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Figure 13-12 

MLD d'une association N:M 
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Association réfiexive 

Si l'association est réfiexive, eiie devient une table dont la clé est la concaténation des clés des deux 
éléments associés. Ce serait le cas de l'association conjointe envisagée plus haut. 



Le MLD de la base magasin en ligne 

En appliquant les règles énoncées précédemment, le MLD de la base magasin du site 
de commerce en ligne est construit à partir du MCD représenté à la figure 13-8 de la 
manière suivante : 

• Les entités client, commande et article deviennent des tables. 

• L'association passe qui relie les entités cl ient et commande ne devient pas une table. La 
clé primaire de la table commande reçoit la clé primaire de la table client comme clé 
étrangère. 

• L'association contient, dont les cardinalités maximales sont de type N:M, devient une 
table nommée 1 i gne, dont chaque occurrence représente une ligne d'une commande. La 
clé primaire de cette table est la concaténation des clés id_comm de la table commande et 
id_article de la table article. Elle reçoit les attributs quantité et prix_unit. 



L'attribut prix_unit 

L'attribut prix_unit n'existe que pour permettre de retrouver la réalité d'une commande ancienne, même 
après modification d'un tarif dans la table article. 

La figure 13-13 présente le MLD obtenu. 
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Figure 13-13 

MLD de la base magasin en ligne 



Modèle physique de données 

Le modèle physique de données est l'implémentation matérielle du MLD créé sur un 
système (SGBDR) donné. Il est réalisé à l'aide du langage SQL (Structured Query 
Language) et des particularités de chaque système, tel que MySQL, SQLite ou Microsoft 
Access. L'apprentissage du langage SQL spécifiquement orienté vers MySQL fait l'objet 
du chapitre suivant. 
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Exercices 

Exercice 1 

Créez le MCD d'une base de données voiture qui enregistre les certificats d'immatricu- 
lation des véhicules en circulation (carte grise). Elle doit répondre aux contraintes 
suivantes : 

• Un véhicule est d'un modèle donné identifié par un numéro de type. 

• Un véhicule peut avoir un ou plusieurs propriétaires simultanément (copropriété). 

• Les recherches effectuées sur la base doivent permettre de retrouver, par exemple, tous 
les véhicules d'une personne, la ou les personnes propriétaires d'un véhicule dont on 
connaît l'immatriculation et tous les propriétaires d'un modèle de voiture donné. 

Exercice 2 

Créez le MLD de la base voiture à partir du MCD de l'exercice 1. Vérifiez la conformité 
du modèle par rapport aux formes normales. 

Exercice 3 

Créez le MCD d'une base de données tournoi permettant d'enregistrer les participants à 
un tournoi de tennis et l'ensemble des matches joués en trois sets au maximum. La base 
doit enregistrer les participants d'un match donné, ainsi que le gagnant et le score de 
chaque set. 

Exercice 4 

Créez le MLD de la base tournoi , et vérifiez sa conformité. 
Exercice 5 

Créez le MCD d'une base permettant à un groupe de gérer les droits d'auteur des livres 
publiés par ses différentes maisons d'édition. Elle doit répondre aux contraintes suivantes : 

• Un livre peut être écrit par un ou plusieurs auteurs. Un auteur peut écrire un ou 
plusieurs livres. Chaque auteur touche un pourcentage des droits totaux d'un livre en 
fonction de sa participation. 

• Un livre est publié par un seul éditeur. 
Exercice 6 

Créez le MLD correspondant à la base de l'exercice 5, et vérifiez sa conformité. 



14 

Le langage SQL 
et phpMyAdmin 



Créé par IBM il y a plus de trente cinq ans en tant que langage de manipulation de 
données, le SQL (Stmctured Query Language) est aujourd'hui le standard de la plupart 
des SGBDR, notamment de MySQL et de SQLite, présentés en détail dans cet ouvrage. 
Ce langage a fait l'objet de normalisations successives de la part de l'ANSI {American 
National Standards Institute) pour aboutir en 1992 à SQL 2 puis en 1999 à SQL 3 et 
enfin à SQL 2003, ce qui montre une constante évolution afin de s'adapter aux besoins. 

Malgré cet effort de standardisation, chaque SGBD adapte le langage SQL, en n'utilisant 
que certaines fonctionnalités et en en ajoutant d'autres, non standards. Si vous avez déjà 
une connaissance de SQL acquise pour un autre système que MySQL vous ne serez pas 
désorientés. Il vous faudra simplement effectuer quelques adaptations non fondamen- 
tales. Toutes les commandes utilisées dans ce chapitre sont celles de MySQL. 



L'interface phpMyAdmin 

Même si le couple PHP-MySQL est le plus répandu actuellement sur le Web, MySQL est 
accessible à d'autres langages, notamment Java. La totalité des hébergements PHP- 
MySQL offrent une interface nommée phpMyAdmin, à partir de laquelle il est possible, 
pour l'administrateur seulement, d'effectuer toutes les opérations de création de base et de 
tables, d'insertion ainsi que de sélection de données. L'interface phpMyAdmin installée 
sur vos serveurs local et distant est en réalité un formulaire écrit en PHP permettant 
d'agir sur la base. 
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L'interface phpMyAdmin vous pennet d'envoyer au serveur des requêtes SQL de créa- 
tion et d'administration de base sans avoir à les écrire. L'interface affiche de surcroît le 
code SQL de la requête qui vient d'être exécutée. 

Pour y accéder à partir d'un navigateur, il vous suffit de saisir les adresses suivantes : 
en local : 

I http://localhost/phpmyadmin 
ou : 

[ http://127.0.0.1/phpmyadmin 
pour des serveurs distants : 
I http://sql.votresite.com 
ou 

I http://www.votresite.com/phpmyadinin 
ou encore parfois : 

I http : / /www . vot resi te . com/phpMyAdmi n 

selon la sensibilité à la casse de votre serveur et la casse employée pour le répertoire 
correspondant. 

Les options d'accès sont communiquées par l'hébergeur lors de la souscription d'un 
abonnement. 

En local, vous obtenez la page d'accueil illustrée à la figure 14-1. La version actuelle de 
phpMyAdmin fournie sur le serveur local installé avec Wampserver étant la 2.1 1.6, c'est 
avec cette version que vous allez travailler. Pour une version différente, certaines actions 
doivent être adaptées en saisissant les requêtes SQL correspondantes. 

Certains hébergeurs, tel ovh.net, autorisent l'accès au répertoire contenant le code de 
phpMyAdmin. Il est de la sorte possible d'installer la dernière version en la téléchargeant 
à l'adresse http:/lwww.phpmyadmin.net/home jpagelMex.php. 

Les sections qui suivent expliquent comment créer une base de données à l'aide de 
phpMyAdmin et détaillent les tables qui la composent, ainsi que les commandes permet- 
tant d'y insérer des informations, de les modifier ou de les mettre à jour et d'effectuer les 
différentes formes de sélection de données destinées à la création de pages Web dynami- 
ques. Vous verrez, dans les chapitres suivants, comment interfacer PHP et MySQL au 
moyen des fonctions spécialisées ou d'objets et méthodes disponibles dans les différents 
modules spécialisés fournis par PHP. 
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Figure 14-1 

Page d'accueil de phpMyAdmin 



Création d'une base de données 

De nombreux hébergeurs, qu'ils soient gratuits ou payants, n'offrent la possibilité de 
créer qu'une seule base de données sur leur serveur. Vous verrez cependant qu'il est 
possible de créer en local plusieurs bases différentes. 

Pour attribuer un nom à une base, il faut respecter les conventions suivantes, lesquelles 
s'appliquent également aux noms des tables, attributs (colonnes), index et alias utilisés : 

• Les caractères autorisés sont les caractères alphanumériques et de soulignement („) 
ainsi que le signe dollar ($). 



Slash et antislash 

Pour éviter de confondre ces noms avec les noms des variables PHP utilisées dans un même code, il est 
déconseillé d'utiliser les caractères slash (/), antislash (\) et le point. 
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• Le nombre de caractères est limité à 64, extensible à 255 pour les noms d'alias. Plus le 
nom est long, plus il y a de risque d'erreur en le recopiant. 

• Un nom peut commencer par un chiffre mais ne doit pas contenir que des chiffres. 

• La sensibilité à la casse dépend du système d'exploitation. Autant considérer que 
MySQL est sensible à la casse et surtout éviter de changer de casse dans une même 
requête, notamment pour les noms d'alias de table. 

Pour créer la base, il suffit de saisir le nom de la base désirée (ici magasi n) dans la zone de 
saisie de la page d'accueil de phpMyAdmin et de cliquer sur le bouton Créer (voir 
repère O de la figure 14-1) en précisant les jeux de caractères à utiliser pour la 
connexion (repère 0) et les données (repère 0). Une fois la base créée, son nom appa- 
raîtra dans la partie gauche de l'interface (repère 0). 

Comme expliqué précédemment, phpMyAdmin génère automatiquement le code SQL 
de l'action effectuée. Après avoir cliqué sur le bouton de création, une nouvelle page 
semblable à celle illustrée à la figure 14-2 s'affiche, confirmant la création de la base 
(repère Q) st affiche le code de la requête SQL suivante (repère 0) : 

I CREATE DATABASE magasin DEFAULT CHARACTER SET latinl COLLATE latinl_bin: 



Délimitation des noms 

phpMyAdmin ajoute systématiquement le caractère ~ dans le code SQL généré de façon à délimiter les 
noms des bases, tables et colonnes. Cela n'est toutefois guère utile dans la mesure où les noms utilisés 
pour les bases, tables et colonnes ne risquent pas d'être des mots réservés par IVlySQL. 



En ajoutant l'option IF NOT EXISTS avant le nom de la base, cette dernière n'est créée que 
si elle n'existe pas déjà. Cela évite les messages d'erreur, surtout si la requête est envoyée 
par un script PHP. 

Avec cette option, la requête précédente devient : 

I CREATE DATABASE IF NOT EXISTS magasin DEFAULT CHARACTER SET latinl 
^COLLATE latinl_bin: 

Pour détruire la base, il suffit de la sélectionner puis de cliquer sur le bouton "Supprimer" 
(voir repère 0 de la figure 14-2). Le code SQL correspondant s'affiche : 

[ DROP DATABASE magasin; 

Comme précédemment, l'usage de l'option IF EXISTS avant le nom de la base empêche 
l'apparition d'une erreur si vous tentez de supprimer une base qui n'existe pas. 

Avec cette option, la requête devient : 

I DROP DATABASE IF EXISTS magasin 

Avant d'effectuer d'autres opérations, il vous faut sélectionner la base sur laquelle vous 
voulez travailler. 
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Nom 
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Figure 14-2 

La page de confirmation de création de la base 



Destruction 

La destruction d'une base entraîne aussi celle de toutes les tables et de toutes les données qu'elle 
contient. Il convient donc d'être prudent avant d'utiliser cette requête. 



Création de tables 

Une table est composée de colonnes, ou champs. Chacune de ces colonnes est doté d'un 
type particulier, censé correspondre le mieux possible à l'information qu'elle contient. 
Avant de créer une table, il importe de connaître les différents types de données proposés 
par MySQL. Le choix judicieux de ce type réduit l'espace disque utilisé. 

Cette section présente les différents types de données reconnus par MySQL ainsi que les 
commandes SQL utilisables pour créer les tables. MySQL permet de créer des tables de 
types différents, en particulier MylSAM et InnoDB. InnoDB est d'ailleurs maintenant le 
type proposé par défaut par phpMyAdmin et c'est celui que nous utiliserons car il offre 
plus de possibilités, comme les contraintes de clés étrangères et les triggers. 
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Les types de données MySQL 

MySQL permet de stocker des informations selon de nombreux types de données. Cela 
donne la possibilité d'adapter le plus précisément possible le type de donnée à l'informa- 
tion qui est enregistrée dans une table. Le choix du type doit se faire de telle sorte que 
l'information occupe le moins d'octets possible. 

Les types numériques 

Les types numériques permettent de stocker toutes sortes de valeurs numériques entières 
ou décimales avec des intervalles de valeurs très étendus. Comme expliqué précédem- 
ment, il est important d'adapter le type choisi au format de l'information stockée afin de 
ne pas occuper plus d'espace serveur que nécessaire et, par voie de conséquence, de ne 
pas allonger inutilement les temps de réponse des recherches effectuées. 

Le tableau 14-1 présente les différents types de données numériques. 



Tableau 14-1 - Les types de données numériques 



Type 


Définition et caractéristiques 


TINYINT 


Un très petit entier prenant des valeurs de -128 (- 2'') à 127 (2^ - 1). S'il 
est suivi de l'option UNSIGNED, les valeurs sont positives et varient de 0 à 
255 (2^ - 1). Chaque valeur occupe 1 octet. 


SMALLINT 


Un petit entier prenant des valeurs de -32768 (- 2^=) à 32767 (2^= - 1 ). S'il 
est suivi de l'option UNSIGNED, les valeurs sont positives et varient de 0 à 
65536 (2^^- 1). Chaque valeur occupe 2 octets. 


MEDIUMINT 


Entier moyen prenant des valeurs de -8388608 (- 2^3) à 8388607 (2=3 - i ). 
S'il est suivi de l'option UNSIGNED, les valeurs sont positives et varient de 0 
à 16777215 (22^-1). Chaque valeur occupe 3 octets. 


INTou INTEGER 


Entier prenant des valeurs de -2147483648 (-231) à 2147483647 
(2^1 - 1). S'il est suivi de l'option UNSIGNED, les valeurs sont positives et 
varient de 0 à 4294967295 soit 2^2 - 1 . Chaque valeur occupe 4 octets. 


BIGINT 


Grand entier prenant des valeurs de -9223372036854775808 (-2^^) à 
9223372036854775807 (263-1). S'il est suivi de l'option UNSIGNED, les 
valeurs sont positives et varient de 0 à 18446744073709551615, soit 
2^-^. Chaque valeur occupe 8 octets. 


FLOAT 


Nombre à virgule flottante en simple précision prenant des valeurs de 
-3.402823466E+38 à -1 . 75494351 E-38 pour les nombres négatifs et de 
1.75494351E-38 à 3.402823466E+38 pour les positifs. S'il est suivi de 
l'option UNSIGNED, les valeurs sont uniquement positives. Avec les options 
FLOAT (M,D), l'affichage s'effectue avec M chiffres dont D décimales. 
Chaque valeur occupe 4 octets. 


DOUBLE 


Nombre à virgule flottante en double précision prenant des valeurs 
de -1.7976931348623157E+308 à - 2 . 2250738585072014E - 308 
pour les nombres négatifs et de 2 . 2250738585072014E-308 à 
1 . 7976931348623157E+308 pour les positifs, auxquelles s'ajoute la valeur 
exacte de 0. S'il est suivi de l'option UNSIGNED, les valeurs sont uniquement 
positives. Avec les options DOUBLE (M,D) l'affichage se fait avec M chiffres 
dont D décimales. Chaque valeur occupe huit octets. 
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Tableau 14-1 - Les types de données numériques (suite) 



Type Définition et caractéristiques 

DECIMAL Nombre à virgule flottante qui doit être signé. La valeur est stockée comme 

une chaîne de caractères dont chaque caractère est un chiffre. Les valeurs 
sont les mêmes que pour le type DOUBLE. S'il est suivi de l'option UNSI- 
GNED, les valeurs sont uniquement positives. Avec les options DECIMAL 
(M), l'affichage s'effectue avec M chiffres (par défaut 10 chiffres), ce qui 
limite l'intervalle de valeurs. Avec les options DECIMAL (M,D), l'affichage 
s'effectue avec M chiffres dont D décimales. Chaque valeur occupe autant 
d'octets qu'il y a de caractères dans le nombre. 



Les types chaînes de caractères 

Ces types permettent de stocker des chaînes de caractères de longueurs très diverses, 
allant du simple caractère au discours fleuve d'un visiteur prolixe dans un livre d'or. A 
nouveau, il vous faut penser à adapter le type de donnée à ce que vous désirez stocker 
afin d'utiliser le moins d'octet possible. 

Le tableau 14-2 présente les différents types de données chaînes de caractères. 



Tableau 1 4-2 - Les types chaînes de caractères 



Type 


Définition et caractéristiques ^ 


CHAR(M) 


Chaîne de caractères de longueur fixe de M caractères complétée par des 
espaces si la donnée stockée est plus petite. Les espaces sont supprimées 
lors de la lecture. La longueur indiquée varie de 0 à 255 caractères. 
L'option CHAR(M) BINARY rend la chaîne sensible à la casse lors des 
recherches. Une colonne de type CHAR(O) n'occupe qu'un octet et peut 
contenir les valeurs NULL et " " (chaîne vide), ce qui permet de simuler une 
valeur booléenne. La chaîne stockée occupe toujours M octets, même si 
elle ne contient qu'un seul caractère significatif. 


VARCHAR(M) 


Chaîne de caractères de longueur variable comprise entre 1 et M carac- 
tères. La valeur de M varie de 1 à 255 caractères. L'option VARCHAR(M) 
BINARY rend la chaîne sensible à la casse lors des recherches. La chaîne 
stockée occupe N + 1 octets quand elle comprend N caractères. 


TINYTEXT 
TINYBLOB 


Texte d'une longueur comprise entre 1 et 255 caractères. Le type TINY- 
BLOB est sensible à la casse. La chaîne stockée occupe N + 1 octets quand 
elle comprend W caractères. 


TEXT 
BLOB 


Texte d'une longueur comprise entre 1 et 65 535 caractères. Le type BLOB 
est sensible à la casse. La chaîne stockée occupe W + 2 octets quand elle 
comprend N caractères. 


MEDIUMTEXT 
MEDIUMBLOB 


Texte d'une longueur comprise entre 1 et 16 777 215 caractères. Le type 
MEDIUMBLOB est sensible à la casse. La chaîne stockée occupe N + 3 
octets quand elle comprend N caractères. 


LONGTEXT 
LONGBLOB 


Texte d'une longueur comprise entre 1 et 4 294 967 295 caractères. Le 
type LONGBLOB est sensible à la casse. La chaîne stockée occupe W + 4 
octets quand elle comprend W caractères. 
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I Type 



Tableau 14-2 - Les types chaînes de caractères (suite) 
Définition et caractéristiques 



ENUM( ' chaîner Permet le choix d'une seule valeur parmi l'énumération des N chaînes de 

' chaineN') caractères définies dans le type. La valeur NULL est toujours admise, 

même si elle ne figure pas dans la liste. Le type peut définir jusqu'à 
65 535 valeurs. À chaque chaîne correspond une valeur numérique de 1 à 
65 535, correspondant à son ordre d'apparition dans la définition du type. 
La valeur 0 correspond à une chaîne vide. La définition de ENUM ('bleu', 
'bl anc' , ' rouge' ) pour une colonne ne permet de stocker qu'une valeur 
parmi les trois couleurs de la liste ou la valeur NULL. Pour le HTML, ce type 
correspond à une liste de sélection <select> de N+1 <option> (les N 
valeurs proposées plus le choix NtJLL par défaut) à choix unique. 

SET( ' chai nel ' Permet le choix de une ou plusieurs valeurs simultanément parmi l'ensem- 

' chaineN' ) ble des N chaînes de caractères définies dans le type. L'ensemble peut 

contenir jusqu'à 64 valeurs. À chaque choix correspond une valeur numé- 
rique entière égale à 2"-^ si n est la position de la chaîne dans l'ensemble 
(soit 1 pour la première, 2 pour la deuxième, 4 pour la troisième, etc.) ou 
encore une valeur binaire dans laquelle chaque bit est à 1 si la valeur est 
choisie (soit 0001 pour la première, 0010 pour la deuxième, 0100 pour la 
troisième, etc.). Si plusieurs valeurs sont choisies, la valeur numérique 
correspondante est la somme des valeurs de chacune (par exemple 5 pour 
la première et la troisième valeur). En HTML, ce type correspond à une liste 
de sélection <select> de N <cption> à choix multiple (avec l'attribut 
multiple). I 



Les types de dates et d'heures 

Les types de dates et d'heures permettent de stocker des dates dans des formats diffé- 
rents, allant de la simple année seule à l'ensemble date complète plus heure complète à la 
seconde près. 

Pour stocker un timestamp UNIX tel que détaillé au chapitre 8, il est préférable d'utiliser 
une colonne de type entier INT(IO), qui facilite les opérations. 

Le tableau 14-3 présente les différents types de données de dates et d'heures. 



Tableau 14-3 - Les types de dates et d'heures 



Type 


Définition et caractéristiques 


DATE 


Une date au format AAAA-MM-JJ dans l'intervalle de 1000-01-01 à 9999- 
12-31. Chaque enregistrement occupe 3 octets. 


DATETIME 


Contient la date et l'heure au format AAAA-MM-JJ HH : MM : SS dans l'inter- 
valle de 1000-01-01 00:00:00 à 9999-12-31 23 : 59 : 59. Chaque enre- 
gistrement occupe 8 octets. 


TIMESTAMP[(M)] 


Stocke une date complète sous la forme AAAAMMJJHHMMSS sans rapport 
direct avec un timestamp UNIX tel que retourné par la fonction timeO 
détaillée au chapitre 8. 
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Tableau 14-3 - Les types de dates et d'heures (suite) 

Il faut toutefois prendre des précautions pour effectuer des calculs avec ce 
type de valeur. En effet, le calcul 20030506232009 + 1030 n'ajoute pas 
1 030 secondes mais 10 minutes et 30 secondes. De plus, i'addition peut 
conduire à des dates invalides par dépassement des valeurs admises 
(25 heures, par exemple). Le paramètre M facultatif détermine le nombre 
de caractères utilisé pour afficher la date. Ce doit être un nombre pair. Sa 
valeur par défaut est 14. 

En fonction de la valeur de M, vous obtenez les formats d'affichage 
suivants : 

TIMESTAMP(14) AAAAMHJJHHMMSS 
TIMESTAMP(12) AAMMJJHHMMSS 
TIMESTAMP(IO) AAMMJJHHMM 
TIMESTAMP(8) AAAAMMJJ 
TIMESTAMP(6) AAMMJJ 
TIMESTAMP(4) AAMM 
TIMESTAMP(2) AA 

Chaque enregistrement occupe quatre octets. 

TIME Stocke l'heure au format HH:MM:SS ou HHH:MM:SS pour un intervalle de 

valeurs allant de -838:59:59 à 838:59:59 permettant d'effectuer des 
calculs de durée excédant 24 heures. Chaque enregistrement occupe 
3 octets. 

YEAR Représente les années au format YYYY pour un intervalle allant de 1901 à 

2155. Si l'année est fournie avec deux chiffres, les valeurs de 00 à 69 
correspondent aux années 2000 à 2069 et les valeurs 70 à 99 aux années 
1970 à 1999. Chaque enregistrement occupe 1 octet. 



Les options des attributs 

Chaque attribut d'une table peut être précisé à l'aide des options suivantes : 

• NOT NULL pour que chaque enregistrement de l'attribut ait obligatoirement une valeur 
ou NULL pour autoriser l'absence de valeur (cette dernière option est interdite pour une 
clé primaire). Nous écrivons, par exemple : 

I nom_attr VARCHAR(IO) NOT NULL 

• DEFAULT 'valeur_défaut' permet de définir une valeur par défaut pour l'attribut si 
aucune valeur n'y est enregistrée. Cette option est impossible pour les types BLOB et 
TEXT. Les valeurs par défaut doivent être des constantes, et il n'est pas possible d'utili- 
ser de fonction pour les définir. 

• AUTO^INCREMENT pour qu'un attribut numérique entier soit automatiquement incrémenté 
d'une unité à chaque insertion d'un enregistrement. Pour que cette contrainte soit vala- 
ble, il faut que l'attribut soit indexé ou qu'il soit la clé primaire. Par exemple, le code 
suivant : 

I nom tinyint NOT NULL auto_increment, INDEX Indnom (nom) 

crée un attribut nom auto-incrémenté NOT NULL et indexé sous le nom indnom. 
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• PRIMARY KEY pour définir l'attribut comme clé primaire de la table. Il est recommandé 
de faire cette déclaration après la définition de tous les attributs. Par exemple, le code 
suivant : 

I nom tinyint(4) NOT NULL AUTO_INCREMENT, PRIMARY KEY (nom) 

définit un attribut nom et une clé primaire sur un attribut. 

Le code suivant : 
I PRIMARY KEY (nom. prénom) 

crée une clé primaire composée des deux attributs, nom et prénom. 

De même, pour définir le ou les index de la table, vous devez faire figurer les contraintes 
suivantes après les définitions d'attributs : 

• LINIQUE(nom_attributl,nom_attribut2 ) pour que chaque enregistrement ait une 

valeur unique dans la colonne des attributs précisés. Par exemple, le code suivant : 

I LINIQLIE(nom, prénom) 

empêche d'enregistrer deux personnes ayant le même nom et le même prénom. Par 
contre, deux noms identiques avec deux prénoms différents sont acceptés. 

• INDEX[nom_index] (nom_attributl ,nom_attribut2 ) crée un index pour la table à 

partir des colonnes précisées. La création d'index sur des colonnes de la table facilite 
les recherches quand ces colonnes sont utilisées comme critère de recherche. Par 
exemple, le code suivant : 

I INDEX mon_index (nom, prénom) 

crée un index nommé mon^index sur les colonnes nom et prénom. 



Création des tables 

Vous allez maintenant créer les tables destinées à contenir les données. Les sections qui 
suivent détaillent les quatre tables à créer pour la base magasi n, les tables cl i ent, commande, 
arti cl e et 1 i gne. La figure 14-3 rappelle le MLD de la base magasin qui va nous permet- 
tre de créer les différentes tables qui la composent. 



client 












article 




commande 




ligne 




id client 


id article 


nom 
prénom 

âge 
adresse 

ville 

mail 


id comm 
id client 
date 


id comm 
id article 
quantité 
prix_unit 


design 
prix 
catégorie 



















Figure 14-3 

Le MLD de la base magasin 
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La table client 

Le code suivant définit les colonnes de la table cl ient. 

I cl ient(id_cl ient, nom, prénom, âge, adresse, ville, mail) 

La colonne id_cl ient est de type MEDIUMINT, avec l'option UNSIGNED sélectionnée. Sa valeur 
est donc un entier positif, avec 16 777 215 clients possibles. Cet attribut étant la clé 
primaire de la table, choisissez dans phpMyAdmin les options PRIMARY KEY (bouton radio 
dans la colonne Primai re de la figure 14-5) et NOT NULL car le champ id_cl ient doit avoir 
obligatoirement une valeur (colonne Nu 11 de la figure 14-5). Ce champ étant incrémenté 
automatiquement d'une unité à chaque nouvelle insertion de donnée, il a également 
l'option AUTO_INCREMENT choisie dans la colonne Extra de la figure 14-5. 

Les colonnes nom, prénom, adresse et ville sont des chaînes de caractères de longueur 
variable, donc de type VARCHAR, avec l'option NOT NULL sélectionnée. 

La colonne âge est un entier positif de petite taille, donc de type TINYINT UNSIGNED. 
L'intervalle des valeurs est de 0 à 255. L'option NULL permet à un client de ne pas saisir 
son âge. 

La colonne mail est également de type VARCHAR, mais cette fois avec l'option NULL sélec- 
tionnée, car un client peut ne pas donner son adresse e-mail. 

La table commande 

La table commande a la structure suivante : 
I commande (id_comm, id_client, date) 

La colonne id_comm est de type MEDIUMINT, avec les options UNSIGNED, NOT NULL et AUTO_ 
INCREMENT sélectionnées, de façon que chaque commande ait un numéro différent. 

La colonne id_client est une clé étrangère issue de la table client. Elle a les mêmes 
caractéristiques que i d_conim. La clé primaire de la table est composée des champs i d_comm 
et id_cl ient. 

La colonne date est de type DATE, avec l'option NOT NULL sélectionnée, de façon que les 
valeurs soient insérées automatiquement sans intervention du client et qu'il n'y ait pas à 
craindre un oubli. 

La table article 

La table arti cl e a la structure suivante : 

I article(id_article, désignation, prix, catégorie) 

La colonne id_article correspond au code de chaque article sur cinq caractères. Elle est 
donc de type CHAR(5), avec les options NOT NULL et PRIMARY KEY sélectionnées. 

La colonne désignation est de type VARCHAR( 100), avec l'option NOT NULL sélectionnée. 
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La colonne prix est de type DECIMAL(8,2). Elle est donc sur huit chiffres, dont deux déci- 
males, avec l'option NOT NULL sélectionnée. 

La colonne catégorie est de type ENUM. Elle comporte une liste de cinq valeurs possibles 
('tous', 'vidéo', 'photo', 'informatique', 'divers' ) avec l'option NOT NULL sélection- 
née et la valeur par défaut ' tous ' . 

La table ligne 

La table 1 i gne a la structure suivante : 
I 1 i gne ( i d_comm, 1 d_a rti cl e, quant lté) 

La colonne id_comm est une clé étrangère issue de la table commande et la colonne id_ 
article une clé étrangère issue de la table article, ces colonnes doivent donc être décla- 
rées avec les mêmes types de données que celles auxquelles elles se réfèrent dans les 
tables commande et article. La colonne quantité est un petit entier de type TINYINT, avec les 
options UNSIGNED et NOT NULL sélectionnées. L'intervalle de valeurs est de 1 à 255. La clé 
primaire de la table est composée des attributs id_comm et id_articl e. 



Hiérarchie base.table.colonne 

Il est possible que plusieurs bases aient des tables de même nom et que des tables différentes aient des 
colonnes de même nom. Pour accéder sans ambiguïté à une colonne précise il faut employer la syntaxe 
suivante : nom_base.nom_table.nom_colonne 



En résumé 

Pour créer une table, par exemple la table cl ient, procédez de la façon suivante : 

1. Sélectionnez la base dans la page d'accueil de phpMyAdmin. 

2. Saisissez un nom pour la table et le nombre de champs qui la composent dans les 
zones de saisie illustrées aux repères 0 et © de la figure 14-4. 

3. Cliquez sur le bouton Exécuter. 
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Figure 14-4 

Création d'une table avec phpMyAdmin 
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Précision 

Dans un premier temps, les champs ville et âge ont été volontairement oubliés afin d'illustrer à la 
section suivante les possibilités de modification des tables offertes par pfipMyAdmin. 



4. Dans la page qui s'affiche, saisissez les caractéristiques des colonnes, ou champs, de 
la table dans un formulaire comptant autant de lignes qu'il y a de champs définis 
(voir la figure 14-5). 
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Figure 14-5 

Création de la table client 



Le code généré par phpMyAdmin est le suivant : 
CREATE TABLE "magasl n\ ~ cl i ent ~ ( 

■id_client~ MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT , 

-nom- VARCHARC 30 ) NOT NULL . 

-prénom" VARCHAR( 30 ) NOT NULL . 

-adresse- VARCHARC 60 ) NOT NULL . 

-mail- VARCHARC 50 ) NULL DEFAULT 'pas de mail'. 

PRIMARY KEY ( -1d_client- ) 

) ENGINE = InnoDB 

Ce code affiche un tableau contenant la structure résumée de la table, comme illustré à la 
figure 14-6. 
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Figure 14-6 

Structure de la table client 
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Vous pouvez créer de la même façon les autres tables de la base magasin en prenant soin 
de respecter les définitions données précédemment. 

Pour chacune de ces tables, le code de création est le suivant : 

• table commande : 

CREATE TABLE "commande" ( 

~id_comm~ mediumint( 8 ) unsigned NOT NULL AUTO_INCREMENT , 
~id_client~ mediumintC 8 ) unsigned NOT NULL , 
-date~ date NOT NULL . 
PRIMARY KEY ( ~id_comm~ . -id_client~ ) . 
INDEX ~id_client~ ( ~id_client~ ) 

) ENGINE = InnoDB DEFAULT CHARSET = latinl COLLATE = latinl_bin AUTO_INCREMENT = 1 
table article : 

CREATE TABLE "magasi n". ~ arti cl e~ ( 
~îd_article- CHAR( 5 ) NOT NULL . 
^désignation" VARCHARC 100 ) NOT NULL , 
'prix~ DECIMAL( 8. 2 ) NOT NULL . 

"catégorie" ENUM( 'tous', 'photo', 'vidéo', 'informatique', 'divers' ) NOT NULL 
DEFAULT 'tous', 
PRIMARY KEY ( "îd_article" ) 

) ENGINE = InnoDB CHARACTER SET latinl COLLATE latinl_bin 
table ligne : 

CREATE TABLE "magasi n" . " 1 i gne" ( 

"id_comm" MEDIUMINT UNSIGNED NOT NULL AUTO_INCREMENT , 
"id_article" CHAR( 5 ) NOT NULL , 
"quantité" TINYINT UNSIGNED NOT NULL . 
"prix_unit" DECIMAL( 8, 2 ) NOT NULL , 
PRIMARY KEY ( "id_comm" , "id_article" ) 
) ENGINE = InnoDB 

La syntaxe simplifiée de la commande CREATE TABLE est la suivante : 

CREATE [TEMPORARY] TABLE [IF NOT EXISTS] nom_table ( 
nom_colonnel NOM_TYPE [options], 
nom_colonne2 NOM_TYPE [options], 
FOREIGN KEY (nom_col onne , . . . ) 
) 

Le mot-clé TEMPORARY indique que la table n'est créée que le temps de la connexion à la 
base et qu'elle est ensuite effacée. 

Le mot-clé IF NOT EXISTS permet de ne créer la table que si une autre table du même nom 
n'existe pas déjà. En l'absence de cette précision, une erreur se produit si une telle table 
existe déjà. 
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Modification des tables 

Après sa création, une table n'est pas figée. Elle peut évoluer en fonction des besoins, 
soit pour ajouter ou ôter des attributs, soit pour modifier ou ajouter des contraintes, des 
index, par exemple, soit encore pour supprimer toute la table. 

Ajout d'un champ 

Comme expliqué précédemment, vous avez volontairement oublié deux champs de la 
table client pour illustrer les possibilités de modification offertes par phpMyAdmin. 
Vous allez maintenant ajouter ces champs, ville et âge. 

Pour ajouter un champ, il suffit, après avoir choisi la table désirée, de saisir le nombre 
de champs et leur position dans la table, comme l'illustre la figure 14-7 pour l'ajout du 
champ ville après l'adresse. L'ordre des champs n'a pas d'importance pour le stockage 
des données mais relève plutôt d'une convention personnelle de présentation. 



Figure 14-7 

Ajout du champ ville à la table client 
Le code généré est le suivant : 

I ALTER TABLE client ADD ville VARCHAR( 40 ) NOT NULL AFTER adresse ; 
Ajoutez de la même façon le champ âge après le champ prénom. 
Le code généré est le suivant : 

I ALTER TABLE 'client' ADD 'âge' TINYINT UNSIGNED AFTER 'prénom' ; 

Pour obtenir automatiquement la structure finale de la table après exécution de la modifi- 
cation ou à tout moment, il suffit de cliquer sur le bouton Structure (voir figure 14-8). 
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Figure 14-8 

Structure finale de la table client 
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Vous pouvez vérifier qu'elle répond bien à la définidon qui en a été donnée lors de sa 
concepdon. 

Modification des propriétés d'une table 

Le tableau représenté à la figure 14-8 contient six colonnes regroupées sous la catégorie 
Action. Ces colonnes permettent de réaliser les modifications suivantes sur les champs de 
la table : 

• Repère Q : modification des caractéristiques du champ. Par exemple, le code pour 
renommer le champ id_client en num_client et pour qu'il soit de type SMALLINT en 
conservant les autres caractéristiques est le suivant : 

IALTER TABLE 'client' CHANGE 'id_client' 'num_cl ient' SMALLINT NOT 
^NULL AUTO_INCREMENT 

• Repère Q : suppression du champ de la table. Par exemple, le code pour supprimer le 
champ vi 1 1 e est le suivant : 

I ALTER TABLE 'client' DROP 'ville' 

• Repère Q : définition du champ comme clé primaire. Par exemple, le code permettant 
que le champ nom fasse aussi partie de la clé primaire est le suivant : 

IALTER TABLE 'client' DROP PRIMARY KEY . 
ADD PRIMARY KEY ( id_client. 'nom' ) 

Remarquez que la clé primaire est effacée par la commande DROP PRIMARY KEY avant 
d'être recréée avec deux champs au moyen de la commande ADD PRIMARY KEY(id_ 
client, nom). 

• Repère Q : création d'un index pour ce champ. Par exemple, le code pour créer un 
index sur le champ adresse est le suivant : 

I ALTER TABLE 'client' ADD INDEX ('adresse' ) 

Le code pour supprimer cet index est le suivant : 

[ ALTER TABLE 'client' DROP INDEX 'adresse' 

• Repère 0 : définition du champ comme étant à valeur unique. Par exemple, le code 
pour attribuer l'option UNIQUE au champ mai 1 est le suivant : 

I ALTER TABLE 'client' ADD UNIQUE ('mail') 

Le code pour supprimer cette option est le suivant : 

I ALTER TABLE 'client' DROP INDEX 'mail' 

• Repère Q : création d'un index sur le texte entier du champ (sauf s'il est numérique). 
Par exemple, le code pour créer un index sur le champ adresse est le suivant : 

I ALTER TABLE 'client' ADD FULLTEXT ('adresse' ) 
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Le code pour supprimer l'index est le suivant : 
I ALTER TABLE 'client' DROP INDEX 'adresse' 

Suppression ou renommage d'une table 

Pour supprimer une table, il suffit de cliquer sur le bouton "Supprimer" après avoir sélec- 
tionné la base puis la table. Le code suivant s'affiche : 

I DROP TABLE 'client' 

La commande SQL complète de suppression d'une ou de plusieurs tables simultanément 
est le suivant : 

I DROP TABLE [IF EXISTS] nom_tablel [, nom_tabl e2 . . . . ] 

L'option IF EXISTS évite de provoquer une erreur au cas où vous tentez d'effacer une 
table qui n'existe pas. 

La commande suivante permet de renommer une ou plusieurs tables : 
I RENAME TABLE ex_noin_tabl el TO new_nom_tabl el [, ex_noin_table2 TO new_nom_tabl e2] 
Par exemple, le code pour renommer la table cl i ent en cl i entbi s est le suivant : 
I RENAME TABLE client TO clientbis 

Création des clés étrangères 

En examinant le schéma du modèle logique de données de la figure 14-3, nous pouvons 
constater que les tables commande et ligne comportent des attributs qui sont les copies 
d'attributs d'autres tables. Chaque attribut id^client de la table commande est le report 
d'un attribut du même nom de la table cl i ent. De même dans la table ligne, chaque attri- 
but id_comm est le report d'un attribut id_comm de la table commande et l'attribut idjrticle 
celui de l'attribut de la table articl e. On dit que chacun d'eux est une clé étrangère, car il 
a la valeur de la clé primaire d'une autre table, ou bien parce qu'il fait référence à la clé 
d'une autre table. Si nous laissions les quatre tables de la base magasin dans l'état où elles 
sont actuellement, nous nous exposerions à la création d'incohérences dans la base lors 
de son utilisation. Par exemple, la suppression d'un client laisserait présentes toutes ses 
commandes dans la table commande, et la table 1 igne contiendrait un attribut id_cl ient qui 
ne correspondrait plus à personne. Pour pallier cet inconvénient lors de la suppression 
d'un client, il faudrait écrire « à la main » les requêtes pour effacer les lignes superflues 
dans les tables commande et ligne. En référençant les clés étrangères, MySQL se charge 
d'éliminer, dans la table commande, les lignes dont l'attribut id_client a la valeur de rid_ 
cl i ent supprimé dans la table cl i ent. De même, lors d'une insertion, MySQL vérifie si la 
clé étrangère insérée existe bien dans la table référencée. Les tables de type InnoDB 
permettent de gérer les contraintes de clés étrangères. 

Pour référencer les clés étrangères, il nous faut tout d'abord créer, dans la table 
commande, un index pour l'attribut id_client. Ceci peut se faire avec phpMyAdmin en 
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cliquant sur l'onglet Structure, puis en cochant la ligne id_client et la case Index, ou en 
tapant le code suivant dans la zone de saisie de l'onglet SQL : 

I ALTER TABLE commande ADD INDEX(id_cl ient) 

Pour créer les contraintes de clé étrangères, il faut sélectionner la table commande, puis 
cliquer sur le lien Gestion des relations et choisir l'attribut id_cl ient puis le lier à un de 
ceux qui apparaissent dans la première liste déroulante (figure 14-9 repère O)- Vous 
devez ensuite choisir les actions que MySQL va effectuer en cas de suppression d'une 
valeur de id_client dans la table client (repère©, case ON DELETE), le choix le plus 
courant étant CASCADE, qui entraînera la suppression des lignes dans la table commande si on 
supprime la valeur liée dans la table cl ient (par conséquent, si on supprime un client ses 
commandes seront aussi supprimées). Les autres choix sont SET NULL, NO ACTION et 
RESTRICT. De même, vous devez choisir l'action à effectuer en cas de mise à jour des 
données dans la table client (repère 0, case ON UPDATE) avec les mêmes choix qui ci- 
dessus. Le code généré est le suivant : 

ALTER TABLE "commande^ 
ADD CONSTRAINT ~ commande.! bf k_r FOREIGN KEY ( ~ id_cl ient" ) REFERENCES 
^~client~ (-id_client~) ON DELETE CASCADE ON UPDATE CASCADE; 
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Figure 14-9 

Création des relations entre les tables 

Exportation d'une table 

Une fonctionnalité très intéressante offerte par phpMyAdmin est la possibilité d'exporter 
dans un fichier tout le code SQL de création d'une table. Ce fichier, dont l'extension est 
. sql , permet par exemple, en phase de test, de créer rapidement sur un serveur distant les 
mêmes tables que celles créées sur le serveur local. 

Il est en outre possible d'exporter les données insérées dans la table locale en même temps 
que la structure de la table et de les retrouver telles quelles dans la base de l'hébergeur. 

Pour exporter une table, il suffit de cliquer sur le bouton Exporter après avoir choisi la 
base et la table concernées. Dans la page qui s'affiche comme illustré à la figure 14-10, il 
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est possible de choisir le format d'exportation (repères Q à 0), ainsi que l'exportation de 
la structure de la table (repère ©) avec ou sans les données qu'elle contient (repère Q). 

Seule l'activation de la case Transmettre (repère 0) permet de transmettre ces infor- 
mations dans un fichier, compressé ou non (repère Q). Si la case n'est pas cochée, 
phpMyAdmin affiche le code dans une nouvelle page. 

Le contenu du fichier arti cl e . sql obtenu est le suivant : 

-- phpMyAdmin SQL Dump 
-- version 2.11.6 
-- http://www.phpinyadinin.net 

-- Serveur: localhost 

— Généré le : Lun 01 Décembre 2008 à 13:39 

-- Version du serveur: 5.0.51 

-- Version de PHP: 5.2.6 

SET SQL_M0DE="N0_AUT0_VALUE_0N_ZER0": 



Base de données: 'magasin" 



Structure de la table "article" 



CREATE TABLE "article" ( 

"id_article" char(5) collate latinl_b1n NOT NULL, 
"désignation" varchar(lOO) collate latinl_bin NOT NULL, 
"prix" décimal (8.2) NOT NULL, 

"catégorie" enum( 'tous' , 'photo' , 'vidéo' , 'informatique' , 'divers' ) 
^collate latinl_bin NOT NULL default 'tous', 
PRIMARY KEY ( " i d_arti cl e" ) 
) ENGINE=InnoDB DEFAULT CHARSET=1 atl ni C0LLATE=1 atl nl_bi n ; 



Contenu de la table "article" 



INSERT INTO "article" ("id_article" , "désignation", "prix" , "catégorie" ) VALUES 
('CA300', 'Canon EOS 3000V zoom 28/80', '329.00', 'photo'). 



('CAS07' 
CCPIOO' 
('CS330' 
('DEL30' 



'Cassette DV60 par 5', '26.90', 'divers'), 
'Caméscope Panasonic SV-AV 100', '1490.00', 'vidéo'). 
'Caméscope Sony DCR-PC330' , '1629.00', 'vidéo'), 
'Portable Dell X300', '1715.00', 'informatique'). 
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{'DVD75', 'DVD vierge par 3' . '17.50'. 'divers'), 

{'HP497', 'PC Bureau HP497 écran TFT'. '1500.00'. 'informatique'), 

{'NIK55'. 'Nikon F55+zoom 28/80', '269.00', 'photo'), 

{'NIK80', 'Nikon F80', '479.00', 'photo'), 

{'SAX15', 'Portable Samsung X15 XVM' , '1999.00', 'informatique'), 

{'SOXMP', 'PC Portable Sony Zl-XMP' , '2399.00', 'informatique'); 

Le fichier contient également les données pour remplir la table après sa création. 



Affidugo Favoris Oiis ? 



AtLUeil 



US ligni 



< > 

Fftn^rrft SOI 



Base de données magasin ■ I abic ar^ctc sur le seiveur locafhoat 
! SInictwe I i Mlkhor 1 , S«! 1 [teeherëher 1 k*aém 



[«porter ~~\ I Opération» 



AflitrtM Ik siii^iTM dK tn lithkt 



O L«TeX 



O nnm^ CSV pntw m ftm 

O DoméeiCSV 

OXM. 



El Structwe — 6- 



Q InOurs la valeur courante de rAUTO.NCREMBJT 

P] F^otéoer les noms àti taUu et des chnnoâ par des ' 



rlrwlure Mita forffw de ccwrincnto<fC3 
Q Dates de aéabonATKKf ficdkin/yérifiuilon 



- M DwHicci 7 

E iwerttons cofnpté4M 

n *wo1k)03 étcnduco 

I I IcMsIiuii^tfvn. dékn rOELAYED) 

lypeMïportBtKin: f*SEfïT_ v 



LxDoiie c«eaistremer<(3) i partir du rana n" 



0 iransiMflre 0" 



MnditeilRnnm |_TABLE_ 
Cnmprassmn - 



f— cnmprassmn — 
<s) aucuw O ** 



Figure 14-10 

Page d'exportation des tables 



Pour réutiliser ce fichier sur un serveur distant, il suflït de se connecter au site puis, dans 
le phpMyAdmin du serveur, sélectionner la base et cliquer sur le bouton SQL, comme 
illustré au repère Q de la figure 14-1 1. Dans la page qui s'aflïche, cliquez sur le bouton 
Parcourir (repère 0) pour retrouver le fichier article.sql sur le disque du poste. Après 
un clic sur le bouton Exécuter (repère 0), le serveur exécute le code SQL contenu dans 
le fichier et crée la table correspondante sur le serveur distant. Vous pouvez aussi effec- 
tuer un copier-coller dans la fenêtre SQL. 
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Figure 14-11 

Utilisation d'un fichier .sql pour créer une table 

Insertion de données 

Une fois les tables créées, différents moyens permettent d'y enregistrer les données 
nécessaires au fonctionnement d'un site de commerce en ligne. 

Il existe deux grandes catégories de données, les données statiques, qui ne dépendent que 
de l'administrateur du site, comme celles de la table article, qui constituent le contenu 
du magasin, et les données en provenance des internautes clients du site, qui rempliront 
les autres tables. Ces dernières informations sont obtenues à partir d'un formulaire de 
saisie alors que les données statiques peuvent être enregistrées aussi bien à partir d'un 
formulaire en ligne qu'à l'aide de phpMyAdmin. 

Insertion ligne par ligne 

Vous allez commencer par insérer les données dans la table a rti cl e. Il suffit pour cela de 
cliquer sur la base magasin dans la page d'accueil de phpMyAdmin puis, dans l'ensemble 
des tables de la base qui s'affichent, de sélectionner la table voulue et de cliquer sur le 
bouton Insérer. Un formulaire de saisie s'affiche alors comme illustré à la figure 14-12. 

En cliquant sur le bouton "Enregistrer", vous générez l'affichage du code SQL de la 
requête, par exemple le suivant : 

INSERT INTO 'article' ( 'id_article' , 'désignation' , 'prix' , 'catégorie' ) 
VALUES ( 

'CSllO'. 'Caméscope Sony 110', '1250.50', 'vidéo' 
): 
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Champ 


Type Fonction 


HuD Valeur 


idjarticle 


varchar(5) 


V 


jcsiio 


désignation 


vorclMi<100) { 


V 


jCaméscope Gony 110 


prix 


decimair8.2) 


V 


|l 250.50 


catégorie 


enum 







parjp prênRrtftr#fi 

Inséref en tant oue nouvel enreaistrement -et-- Ou 

Oinsftrpff un nniiwj ftni-RgiRtrftmftnt 

I Exécuter 1 1 Réinitialiser les valeurs | 

Figure 14-12 

Insertion de données ligne par ligne 

La syntaxe générale de la commande INSERT se décline sous trois formes. 

Dans une première forme, le nom des colonnes est facultatif si les valeurs sont insérées 
dans le même ordre que celui de la table : 

INSERT [DELAYED | LOW_PRIORITY] [IGNORE] 
INTO table [coU .col 2 . . . . ] 
VALUES (vall.val2,...) 

Le mot-clé DELAYED indique que les données ne seront insérées qu'après exécution des 
autres commandes SQL. Le mot-clé LOW_PRIORITY indique au serveur d'attendre qu'il n'y 
ait plus aucun client connecté pour insérer les données. Le mot-clé IGNORE permet de ne 
pas insérer de lignes qui existent déjà. 

La deuxième forme n'est qu'une variante de la première, dans laquelle vous définissez 
explicitement la valeur de chaque colonne. Elle est de préférence employée pour n'insé- 
rer des valeurs que dans certaines colonnes : 

INSERT [DELAYED | LOW_PRIORITY] [IGNORE] 
INTO table 

SET coll= vall,col2= val2.... 

La dernière forme permet d'insérer des données à partir du résultat d'une sélection 
opérée dans une autre table. Vous pourriez, par exemple, créer une table ne contenant que 
le nom et l'adresse e-mail des clients et la remplir à l'aide de cette commande à partir de 
la table client : 

INSERT [DELAYED | LOW_PRIORITY] [IGNORE] 
INTO table [coll.col2. . . .] 
SELECT expression 



INSERT et REPLACE 

Vous pouvez utiliser la commande REPLACE à la place de I NSERT avec la même syntaxe. Elle sert à modifier 
les valeurs d'une ligne sans modifier son identifiant. 
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Mise à jour des données 

Lors du cycle de vie d'une base de données, il peut être indispensable de mettre à jour 
certaines données sans avoir à supprimer une ligne complète puis réécrire les nouvelles 
informations. 

La première solution est bien sûr d'utiliser phpMyAdmin, de sélectionner la base, d'affi- 
cher la table et de cliquer sur l'icône Modifier, ce qui entraîne l'affichage d'une page de 
saisie. Vous pouvez alors modifier une ou plusieurs valeurs de la ligne concernée. 

Pour réaliser cette opération avec une requête SQL, vous disposez de la commande UPDATE, 
dont la syntaxe générale est la suivante : 

UPDATE[LOW_PRIORITY] [IGNORE] nom_table 
SET colonnel = valeurl,colonne2=valeur2.... 
[WHERE condition 
[LIMIT N] 

La condition qui suit la commande WHERE peut permettre d'opérer une mise à jour unique- 
ment pour les lignes répondant à une condition particulière. La clause LIMIT permet de 
limiter la mise à jour aux A' premières lignes. 

Par exemple, pour modifier la date d'une commande dans la table commande, si l'identi- 
fiant de commande a la valeur 2, vous écrivez la requête suivante : 

I UPDATE commande SET date = '2008-11-25' WHERE id_comm = '2' LIMIT 1 ; 



Importation à partir d'un fichier texte 

L'insertion ligne par ligne devient rapidement rébarbative lorsqu'il s'agit de saisir un 
grand nombre de données. Si ces données sont récupérables à partir d'un catalogue, il 
est possible de les inclure en une seule opération à condition qu'elles soient formatées 
selon les mêmes critères que ceux que vous avez utilisés pour les fichiers texte (voir le 
chapitre 11). 

Chaque donnée doit être délimitée par un caractère particulier (par défaut des guillemets) 
et séparée des autres par un autre caractère (par défaut le point-virgule). Chaque groupe 
de données correspondant à une ligne de la table doit être délimité par un troisième carac- 
tère (par défaut la séquence \r\n). 

Pour importer une liste de données dans la table, vous devriez, par exemple, créer le 
fichier article_texte.txt dont le contenu visualisé dans le Bloc-notes de Windows est 
illustré à la figure 14-13. 

Pour réaliser ce type d'importation, vous devez sélectionner la base, puis la table et 
cliquer sur l'onglet Importer. Vous obtenez alors une page identique à celle de la 
figure 14-14. 
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C article_texte Bloc-notes 



BU® 



Fichier Edition Format AFFlchage ? 

"CS330"; "caméscope Sony DCR-PC330" ; "1629" ; "1" 

"NIK55"; "Nikon F55+zoom 28/80" ; "269" ; "photo" 

"NIK80"; "Nikon F80"; "479"; "photo" 

"SOXMP";"PC Portable Sony Zl-XMP" ; "2399" ; "3 " 

"HP497";"PC Bureau HP497 écran TFT"; "1500"; "informatique" 

"DVD75";"DVD Vierge par 3 " ; "17. 50" ; "divers " 



Figure 14-13 

Le fichier texte visualisé dans le Bloc-notes 



l InptuvvtuUs B VyciTviiviriilcdBnib.. ^ Mbwtcf «vk hidoi Abwnc SI Le Mundcli i AiltuMé... B PHP: Swchwgc • Mvi... B PHK lciil*M«i cl ta « LJ hUpy/im|iJi*ihUnl. 



ThcWiCMjrkufiV«l>- 



But d« donntef 



}4| .SniviHii: I(k:jiIIiosI t Hi»« û« iliitiitf»!»: ituiyMiti t |uj lahli*: «lidi» ItmoDH Utm iOWi kH' 
^AHidini liS SHuclum iffSUl j. Htichmdmr i«lnMinK M^'P"''"* (I||l«n|»ofltn ^QpiuMUmt [HVidin Jf, îhipiwhii 



Importer 

richlei 0 Impofiei — 



EniplK«m#ni<fuf>chicf lext« C\wamp\MWw\chapl4\i[_PafC0i«juJ (Tw"* "V""um 2048Kéo) ^ 



Cmi nia(l»!i tir comptiv; 



iiaiil dnhichis iiuln(nulii|(inmoinl 



-Imponailon p«nlcll« 

\J\ Ptnntnr* rinlwruptiof) à» rimportition ti la liiral» d« It«npt «st tur l« poml <rétf« aneinte C«ci pourrait aid*i à impon*r dat fichiMi vohinwiMX. m déirirMiH du laftpaci dit 
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futiniM du licliioi iThniMii 
CSV 

g) CSVvuLOADOA^ 
SQL 
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Caraaére spécial 
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Figure 14-14 

Formulaire d'insertion à partir d'un fichier texte 



Si le fichier est situé sur le poste client, vous pouvez utiliser le bouton Parcourir 
(repère pour le localiser et conserver le choix par défaut DATA LOCAL (repère ©). 

Pour exécuter vous-même cette opération, vous écririez la requête SQL suivante : 

LOAD DATA INFILE ' C : /arti cl e_texte . txt ' 
INTO TABLE ^article^ 
FIELDS TERMINATED BY ' ; ' 
ENCLOSED BY "" 
ESCAPED BY 'W 
LINES TERMINATED BY '\r\n' 
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Vous avez la possibilité de définir vos propres valeurs pour les options suivantes : 

• « Champs terminés par », qui correspond à l'option SQL FIELDS TERMINATED BY. 

• « Champs entourés par », qui correspond à l'option SQL ENCLOSED BY. 

• « Caractère spécial », qui correspond à l'option SQL ESCAPED BY qui permet de choisir 
le caractère d'échappement. 

• « Lignes terminées par », qui correspond à l'option SQL LINES TERMINATED BY. 

Il est cependant préférable de conserver les paramètres par défaut. 

En cliquant sur le bouton Afficher, vous pouvez vérifier que l'insertion des données s'est 
effectuée correctement et en conformité avec le fichier texte. Vous obtenez l'ensemble de 
la table, dans la limite de 30 lignes à la fois, comme illustré à la figure 14-15. 



idaiticle 


désignation 


prix 


catégorie 


CS330 


Caméscope Sony DCR-PC330 


1629.00 


vidéo 


NIK55 


Nikon F55+zoom 2B;B0 


269.00 


photo 1 


NIKBQ 


Nikon FBO 


479.00 


photo 


SOXMP 


PC Portable SonyZI-XMP 


2399.00 


informatique 


HP497 


PC Bureau HP497 écran TFT 


1500.00 


informatique 


DVD75 


DVD vierge par 3 


17.50 


divers 



Figure 14-15 

La table articles après insertion de données 

Si vous souhaitez insérer des données dans une table dont la clé primaire est un entier 
ayant l'option AUTO_INC REMENT sélectionnée, le fichier texte doit contenir à la place de cette 
clé la valeur NULL représentée par la chaîne "\N". Pour insérer une liste de clients dans la 
table cl i ent, par exemple, vous utiliseriez un fichier texte ayant la structure suivante : 

I"\N" ; "Marti " ; "Jean" ; "36" ; "5 av Einstein" ; "Orléans" ;niart@inarti .coin 
"\N" ; "Rapp" ; "Paul " ; "44" ; "8 rue du Port";"Paris";rapp@11bert.com 

Insertion à partir d'un fichier Excel 

La figure 14-16 représente une feuille de tableur Excel contenant un ensemble de données 
présentées selon l'ordre des colonnes de la table arti cl e. Pour les enregistrer dans la table, 
vous devez enregistrer la feuille au format CSV puis choisir « CSV (séparateur : point 
virgule) » comme type de fichier. Vous obtenez un fichier avec l'extension .csv, dont la 
structure est similaire à celle d'un fichier texte, le séparateur choisi entre chaque champ 
étant ;. 
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La procédure d'insertion est la même que pour un fichier texte ordinaire. 



X Microsoft Excel - article_excel 


Fichier Edition Affichage Insertion Format 


Outils Données Fenêtre l 




{{□ »^ H 










s f' Éi II 




Il Arlal 


•r 10 » 


GIS 






W % 000 td§ i'.?, 











C 


D 


E 


1 


CS330 


Caméscope Sony DCR-PC330 


1629 


1 




2 


NIK55 


Nikon F55+zoom 28/80 


269 


photo 




3 


NIKBO 


Nikon F80 


479 


photo 




4 


SOXMP 


PC Portable SonyZ1-XMP 


2399 


3 




5 


HP497 


PC Bureau HP497 écran TFT 


1500 


informatique 




E 


DVD75 


DVD vierge par 3 


17.5 


divers 




7 













Figure 14-16 

Feuille de calcul Excel à insérer 



Les données de la base magasin 

Avant de procéder à des opérations de sélection des données à l'aide de code SQL, il 
vous faut mieux comprendre les résultats affichés par les différentes requêtes sur la base 
magasi n. Ces résultats sont récapitulés aux tableaux 14-4 pour la table cl i ent, 14-5 pour la 
table article, 14-6 pour la table commande et 14-7 pour la table ligne. 



Tableau 14-4 - Données de la table client 



id client 


nom 


prénom 


âge 


adresse 


ville 


mail ' 


1 


Marti 


Jean 


36 


5 av. Einstein 


Orléans 


mart@marti.com 


2 


Rapp 


Paul 


44 


32 av. Foch 


Paris 


rapp@libertcom 


3 


Devos 


Marie 


18 


75 bd Hochimin 


Lille 


grav@waladoo.fr 


4 


Hochon 


Paul 


22 


33 rue Tsétsé 


Chartres 


hoch@fiscali.fr 


5 


Grave 


Nuyen 


18 


75 bd Hochimin 


Lille 


grav@waladoo.fr 


6 


Hachette 


Jeanne 


45 


60 rue dAmiens 


Versailles 


NULL 


7 


Marti 


Pierre 


25 


4 av. Henri 


Paris 


martin7@fiscali.fr 


8 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 


mac@freez.fr 


9 


Basile 


Did 


37 


26 rue Gallas 


Nantes 


bas@walabi.com 


10 


Darc 


Jeanne 


19 


9 av. d'Orléans 


Paris 


NULL 


11 


Gâté 


Bill 


45 


9 bd des Bugs 


Lyon 


bill@microhard.be 
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Tableau 14-5 - Données de la table article 



id_article 


désignation 


prix 


catégorie 




1 


CS330 


Caméscope Sony DCR-PC330 


1629.00 


vidéo 






NIK55 


Nikon F55-i-zoom 28/80 


269.00 


ptioto 






N1K80 


Nikon F80 


479.00 


ptioto 




1 


SOXMP 


PC portable Sony ZI-XIVIP 


2399.00 


informatique 




i 


HP497 


PC bureau HP497 écran TFT 


1500.00 


Informatique 






DVD75 


DVD vierge par 3 


17.50 


divers 






CAS07 


Cassette DV60 par 5 


26.90 


divers 






DEL30 


Portable Dell X300 


1715.00 


Informatique 






CP100 


Caméscope Panasonic SV-AV100 


1490.00 


vidéo 




\ 


SAX15 


Portable Samsung X15 XVM 


1999.00 


informatique 




1 


CA300 


Canon EOS 3000V zoom 28/80 


329.00 


pfioto 




1 


laDieau 14-d — 


Données de la table commande 


Tableau 14-7 - Données de la table ligne 




id_comm 


id_client date 




id„comm id article 


quantité 


prixunit 




1 


5 2008-06-11 




1 CS330 


1 


1629.00 




2 


9 2008-06-25 




1 CAS07 


3 


26.90 


1 


3 


1 2008-07-12 




2 HP497 


2 


1500.00 




4 


3 2008-07-14 




3 NIK80 


5 


479.00 




5 


9 2008-07-31 




4 SOXMP 


3 


2399.00 




6 


10 2008-08-08 




4 DVD75 


2 


17.50 


! 


7 


2 2008-08-25 




5 CA300 


1 


329.00 




8 7 2008-09-04 




6 CAS07 


3 


26.90 




9 


11 2008-10-15 




6 CP100 


1 


1490.00 




10 


4 2008-11-23 




7 SAX15 


5 


1999.00 




11 


8 2009-01-21 




8 SOXMP 


1 


2399.00 




12 


5 2009-02-01 




8 CP100 


1 


1490.00 


1 


13 


9 2009-03-03 




9 NIK55 


1 


269.00 








10 DEL30 


2 


1715.00 








10 SAX15 


1 


1999.00 








11 DVD75 


10 


17.50 








12 CS330 


3 


1629.00 








12 CAS07 


4 


26.90 


1 






13 SAX15 


2 


1999.00 
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Sélection des données 

L'opération la plus importante pour créer une page dynamique en réponse à une 
demande formulée par un visiteur est la sélection des données qui vont composer cette 
page. Il est pour cela nécessaire de bien maîtriser les commandes SQL de sélection des 
données et de s'assurer que l'opération de sélection retenue fournit bien les résultats 
attendus et uniquement ceux-ci. 

La sélection des données peut porter sur une table (sélection simple) ou sur deux ou 
plusieurs tables simultanément (il s'agit alors d'une jointure). Pour illustrer l'importance 
du choix des commandes SQL de sélection, vous n'utiliserez pas les possibilités d'auto- 
matisation du code SQL offertes par phpMyAdmin mais écrirez à la main chacune des 
requêtes à exécuter. 

Commencez par choisir la base magasin, puis la table à interroger et cliquez sur l'onglet 
SQL. Vous obtenez la page illustrée à la figure 14-17. Vous saisirez vos requêtes dans la 
zone de saisie multiligne (repère O), la liste des attributs de la table apparaît dans une 
liste déroulante à droite (repère 0) afin d'éviter les erreurs dans la saisie des attributs. 



jS Seivoun localho«t ^ ligi Baso do données: magasin t o Table: client InnoDB frw -1096 kB' 
RSAmchci 1^ SUucbiie i3 SQL ^ Redieidwi ï>j|tiséiei E!Ex|XMli?i [Slnipoitei S^Opéialions MVIdtfi S! Suppiliiwi 



-Exécuter une ou des requéles sur la base magasin: | 



EZlZCr non, prénom OCM ' cli.cnc ' | 
1 



Champs 



id_clieni 






nom 






pronom 


2 




âge 






ariresKR 







( Dûliriiitvur , ] j R«<iflk:ti(n Ici ii>cfu«l« apiè*) (•xtkuliun 



EMÏculor 



Uuvnf une nouvelle fenêtre phpMyAdmir 



Figure 14-17 

La page de saisie des requêtes 



Sélection dans une table 

La commande SQL essentielle pour opérer des sélections de lignes dans une table est 
SELECT. Elle comporte de nombreuses options en fonction du résultat souhaité. Les 
sections qui suivent détaillent les plus importantes d'entre elles. 



Sélection de toutes les lignes 

Pour opérer une sélection de toutes les lignes et de toutes le colonnes d'une table, écrivez 
I SELECT * FROM client 
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Le seul intérêt de cette requête est de visualiser l'ensemble des données. Elle a le même 
effet que le bouton Afficher de phpMyAdmin. 

Pour restreindre l'affichage à certaines colonnes, vous pouvez les énumérer. 

La commande suivante : 

I SELECT nom, prénom, ville FROM client 

n'affiche que les trois colonnes indiquées avec leurs valeurs pour toutes les lignes de la 
table cl ient. 



Alias 

Dans les requêtes de sélection, vous pouvez définir des alias pour les noms des bases, des tables ou des 
colonnes. Lors de l'affichage, les noms affichés sont ceux des alias et non ceux des colonnes de la table. 

Ces exemples affichent toutes les lignes de la table, y compris si cette dernière contient 
des doublons. Pour ne pas afficher plusieurs fois les mêmes données, vous pouvez utiliser 
la clause DISTINCT. 

L'exemple suivant : 

I SELECT DISTINCT ville FROM client 

affiche la liste des villes sans doublon, comme ci-dessous : 



ville 


Orléans 


Paris 


Lille 


Chartres 


Versailles 


Lyon 


Nantes 



Vous pouvez trier les champs affichés par ordre croissant ou décroissant en utilisant la 
clause ORDER BY du nom du champ et des options ASC (croissant) ou DESC. 

La requête suivante : 

I SELECT DISTINCT ville FROM client ORDER BY ville ASC 
affiche la liste ordonnée des villes, comme ci-dessous : 



ville Chartres Lille Lyon Nantes Orléans Paris Versailles 



La requête suivante : 

I SELECT DISTINCT ville FROM client ORDER BY ville DESC 
affiche la même liste en ordre inverse, comme ci-dessous : 



ville 


Versailles 


Paris 


Orléans 


Nantes 


Lyon 


Lille 


Chartres 
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Restriction du nombre de lignes 

La possibilité de restreindre le nombre de lignes illustre tout l'intérêt des opérations de 
sélection. Elle permet aux données auxquelles est appliquée la restriction de répondre à 
une ou plusieurs conditions particulières. Pour appliquer une restriction, il suffit d'ajou- 
ter la clause WHERE à la commande SELECT. 

La syntaxe générale de la commande SELECT devient : 

I SELECT coll,col2.... FROM table WHERE condition 

La condition peut porter sur n'importe quelle colonne. Elle doit être rédigée à l'aide 
d'opérateurs et de fonctions, à la manière des expressions conditionnelles des instruc- 
tions if. 

Par exemple, pour sélectionner les clients qui habitent Paris, vous écrivez : 
I SELECT nom, prénom, adresse, mail FROM client WHERE ville^'Paris' 
Vous obtenez la liste illustrée à la figure 14-18. 



nom 


prénom 


adresse 


mail 


Rapp 


Paul 


32 AvFoch 


rapp@libert.com 


Marti 


Pierre 


4 Av Henri 


martin7@tiscali.fr 


Darc 


Jeanne 


9 Av d'Orléans 


NULL 



Figure 14-18 

Sélection avec une clause WHERE 

Les opérateurs de comparaison 

Les opérateurs de comparaison sont applicables à tous les types de données. Ils donnent 
pour résultats les valeurs TRUE, FALSE ou NULL. Les opérandes sont convertis en nombre ou 
en chaîne selon le contexte. 

Pour les chaînes, la comparaison est insensible à la casse et ignore les espaces, les tabu- 
lations (\t) et les sauts de ligne (\n). 

Tableau 14-8 - Les opérateurs de comparaison 



Opérateur 


Description 


~1 


Égalité des nombres ou des chaînes de caractères 


<> ou ! = 


Différent de 




<= 


Inférieur ou égal à 




< 


Inférieur à 




>= 


Supérieur ou égal à 




> 


Supérieur à 
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Tableau 14-8 - Les opérateurs de comparaison (suite) 



Opérateur 




Description 


IS NULL 






Retourne TRUE si la valeur est NULL. Par exemple : 

SELECT nom, prénom FROM auteurs WHERE prénom IS NULL 


IS NOT t 


(ULL 




Retourne TRUE si la valeur n'est pas NULL. Par exemple : 

jLLlLI iIUIII , P I eilOIII rKUrI dULeUIS WnLKt pf KriUlll lû liU 1 INULL 


express 
min AND 


BETWEEN 
max 


Retourne TRUE si la valeur est comprise entre mi n et max (limites comprises). Par exem- 
ple, le code suivant sélectionne tous les noms dont l'Initiale est comprise entre A et E : 
SELECT nom FROM client WHERE nom BETWEEN 'A' and 'E' 


express 
min AND 


NOT 
max 


BETWEEN 


Retourne TRUE si la valeur n'est pas comprise entre min et max (limites comprises). Par 
exemple, le code suivant sélectionne tous les noms dont l'Initiale n'est pas comprise 
entre A et E : 

SELECT nom FROM client WHERE nom NOT BETWEEN 'A' and 'E' 


express 


LIKE 


'motif 


Retourne la valeur TRUE si l'expression est conforme au motif défini. Pour définir les 
motifs, vous utilisez deux caractères particuliers, ou jokers : le caractère de souligne- 
ment (_) pour remplacer un caractère quelconque et le caractère % pour remplacer un 
nombre variable de caractères. 

Si le motif est égal à 'chaine_', tous les mots commençant par 'chaîne' suivi de 
n'Importe quel caractère conviennent. SI le motif est égal à '%mar', tous les mots qui 
contiennent la chaîne ' ma r ' précédée de n'importe quel groupe de caractères convien- 
nent. SI le motif est 'Imrl' , toutes les chaînes contenant simplement la chaîne ' ma r ' 
sont valables. Par exemple, le code suivant sélectionne tous les noms qui contiennent 

Ipq Ipttrptî 'tin' ■ 

SELECT nom, prénom FROM client WHERE nom LIKE '^tin' 


express 


NOT 


LIKE 'motif 


Négation de l'opérateur LIKE 


express 


REGEXP 'motif 


Retourne TRUE si le motif de l'expression régulière est trouvé dans la valeur d'une 

rninnnp Par pypmnip lp rnrip <5iii\/3nt qpiprtinnnp tnii'î Ipq nnmq rinnt lp nrpnnm 

^^UIUIIIIC 1 CLi CMjI IILJIC, IC7 VjUUC OUIVOIIL OdC^VjllUIIIIC LUUo IC70 IIUIIIO Uwlll ICJ IJI^^IIUIII 

commence par la lettre J suivie d'une voyelle puis d'un nombre quelconque de caractères : 
SELECT nom 

FROM client WHERE prénom REGEXP 'J[aeiouy] .*' 


express 


NOT 


REGEXP 'motif 


Npnatinn rlp l'nnprfltpiir RFfnPyp 


express 


IN(vall,val2....) 


Retourne TRU E si la valeur est incluse dans l'ensemble des valeurs listées. Par exemple, 
le code suivant sélectionne tous les noms d'auteurs qui ont 21 , 22 ou 23 ans : 

•nFI FPT nnm FROM aiitpurc UHFRF 3np TM ( 9^ 99 9'^) 
OLLLLI ilUlll r i\UI 1 dULcUib WrlLKL oyc ili \ L L , LL , Lo ) 


express 
val2... 


NOT 

) 


IN(vall. 


Retourne TRUE si la valeur n'est pas Incluse dans l'ensemble des valeurs listées. Par 
exemple, le code suivant sélectionne tous les noms d'auteurs qui n'ont ni 21, ni 22 ni 
23 ans : 

SELECT nom FROM auteurs WHERE âge NOT IN (21,22,23) 


ISNULL(express) 


Retourne TRUE si la valeur de l'expression est de type NULL. Par exemple, le code 
suivant sélectionne tous les noms d'auteurs dont l'attribut prénom est vide : 
SELECT nom FROM auteurs WHERE ISNULL(prenom) 


C0ALESCE(coll,col2,...) 


Retourne la première valeur non NULL de la liste passée en paramètre. Par exemple, le 
code suivant retourne tous les e-mails non NULL de la table client, les mails NULL 
étant remplacés par les noms : 
SELECT COALESCE( mail, nom ) FROM client 
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Exemples de requêtes avec des opérateurs 

• Pour sélectionner les clients dont l'âge est supérieur à 40 ans : 

I SELECT nom, prénom, âge, adresse, ville 
FROM client WHERE âge >40 



nom 


prénom 


âge 


adresse 


ville 


Rapp 


Paul 


44 


32 AvFoch 


Pans 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 


Gâté 


Bill 


45 


9 Bd des Bugs 


Lyon 



• Pour sélectionner les clients qui n'ont pas d'adresse e-mail : 

I SELECT nom, prénom, âge, adresse, ville 
FROM client WHERE mail IS NULL 



nom 


prénom 


âge 


adresse 


ville 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Darc 


Jeanne 


19 


9 Av d'Orléans 


Paris 



Pour sélectionner les clients dont les noms commencent par une lettre entre A et H, la 
lettre H n'étant pas prise en compte : 

I SELECT nom, prénom, âge, ville 
FROM client WHERE nom BETWEEN 'A' AND 'H' 



nom 


prénom 


âge 


ville 


Devos 


Marie 


18 


Lille 


Grave 


Nuyen 


18 


Lille 


Basile 


Did 


37 


Nantes 


Darc 


Jeanne 


19 


Paris 


Gâté 


Bill 


45 


Lyon 



Pour sélectionner les articles dont le prix est compris entre 1 000 et 2 000 euros : 
I SELECT id_article, désignation, prix FROM article WHERE prix BETWEEN 1500 AND 2000 
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idarticle 


désignation 


prix 


CS330 


Caméscope Sony DCR-PC330 


1629.00 


HP497 


PC Bureau HP497 écran TFT 


1500.00 


DEL30 


Portable Dell X3CI0 


1715.00 


SAX15 


Portable Samsung X15 XVM 


1999.00 



Pour sélectionner les clients dont l'âge figure dans la liste (18, 19, 20) : 
I SELECT nom. prénom, âge, ville FROM client WHERE âge IN ( 18. 19. 20 ) 



nom 


prénom 


âge 


ville 


Devos 


Marie 


18 


Lille 


Grave 


Nuyen 


18 


Lille 


Darc 


Jeanne 


19 


Paris 



Pour sélectionner les clients qui habitent une avenue, et dont l'adresse contient donc la 
chaîne av. : 

I SELECT nom. prénom, âge, adresse, ville FROM client WHERE adresse LIKE '%Av^' 



nom 


prénom 


âge 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orléans 


Rapp 


Paul 


44 


32 AvFoch 


Paris 


Marti 


Pierre 


25 


4 Av Henri 


Paris 


Darc 


Jeanne 


19 


9 Av d'Orléans 


Paris 



Pour sélectionner les articles de la marque Sony, dont la désignation contient donc la 
chaîne Sony : 

I SELECT id_article. désignation. prix FROM article WHERE désignation LIKE '%Sony^' 



id_aiticle désignation 


prix 


CS330 Caméscope Sony DCR-PC330 


1629.00 


SOXIMP PC Portable SonyZI-XMP 


2399.00 
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Pour sélectionner les clients dont les noms commencent par Ma à l'aide d'une expression 
régulière : 

I SELECT nom, prénom, âge, adresse, ville 
FROM client WHERE nom REGEXP 'Ma.*' 



nom 


prénom 


âge 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orléans 


Marti 


Pierre 


25 


4 Av Henri 


Paris 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 



Les opérateurs logiques 

Il est évidemment possible d'écrire des conditions complexes dans la clause WHERE en 
reliant plusieurs conditions par des opérateurs logiques. La liste et la description de ces 
opérateurs est donnée au tableau 14-9. 

Une expression contenant un ou deux opérandes reliés par un opérateur logique est 
évaluée à TRUE (1), FALSE (0) ou NULL. 



Tableau 14-9 - Les opérateurs logiques 


Opérateur 


Description 


NOT express 
ou lexpress 


Le NON logique renvoie FALSE si express vaut TRUE et réciproquement ou NULL si express vaut 
NULL. Par exemple, le code suivant retourne tous les noms différents de 'dupont ' : 
SELECT nom FROM client WHERE NOT(nom='dupont' ) 


expressl 
AND 

express2 


Le ET logique renvoie TRUE si les deux opérandes sont différents de FALSE et de NULL et renvoie 
FALSE s'ils sont tous deux FALSE. Dans les autres cas, l'évaluation est NULL. Par exemple, le 
code suivant retourne tous les âges des clients nommés 'pierre dupont' : 
SELECT âge FROM client WHERE nom='dupont' AND prenom='pierre' 


expressl 
OR 

express2 


Le OU logique renvoie TRUE si au moins un des opérandes vaut TRUE, NULL si l'un des deux est 
NULL et FALSE dans les autres cas. Par exemple, le code suivant retourne tous les âges des 
clients dont le nom est 'dupont' ou le prénom 'pierre' : 
SELECT âge FROM client WHERE nom='dupont' OR prenom='pierre' 


expressl 
XOR 

express 


Le OU exclusif logique renvoie NULL si l'un des opérandes vaut NULL, TRUE si un seul des deux 
vaut TRUE et FALSE sinon. Par exemple, le code suivant retourne les âges des clients dont le 
nom est 'dupont' et dont le prénom n'est pas 'pierre' ainsi que de ceux dont le prénom est 
'pierre' et dont le nom est différent de 'dupont' : 
SELECT âge FROM client WHERE nom='dupont' XOR prenom='pierre' 



Exemples utilisant les opérateurs logiques 

Pour sélectionner les clients qui ont moins de 30 ans et qui habitent Paris : 

1 SELECT nom, prénom, âge, adresse, ville 

[ FROM client WHERE âge <30 AND ville = 'Paris' 
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nom 


prénom 


âge 


adresse 


ville 


Marti 


Pierre 


25 


4 Av Henri 


Palis 


Darc 


Jeanne 


19 


9 Av d'Orléans 


Paris 



Pour sélectionner les clients qui habitent Lyon ou dont le nom commence par la lettre H : 

I SELECT nom, prénom, âge, adresse, ville FROM client 
WHERE ville='Lyon' OR nom LIKE 'H^' 



nom 


prénom 


âge 


adresse 


ville 


Hochon 


Paul 


22 


33 rue Tsétsé 


Chartres 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Mac Neal 


John 


52 


89 rue Diana 


Lyon 


Gâté 


Bill 


45 


9 Bd des Bugs 


Lyon 



Pour sélectionner les clients qui n'habitent ni à Paris ni à Lyon : 

I SELECT nom, prénom, âge, adresse, ville 
FROM client 
WHERE NOT(ville='Paris') AND NOT(ville='Lyon' ) 



nom 


prénom 


âge 


adresse 


ville 


Marti 


Jean 


36 


5 Av Einstein 


Orléans 


Devos 


Marie 


18 


75 Bd Hochimin 


Lille 


Hochon 


Paul 


22 


33 rue Tsétsé 


Chartres 


Grave 


Nuyen 


18 


75 Bd Hochimin 


Lille 


Hachette 


Jeanne 


45 


60 rue d'Amiens 


Versailles 


Basile 


Did 


37 


26 rue Gallas 


Nantes 



Les opérateurs arithmétiques 

MySQL reconnaît les quatre opérations fondamentales (+, -, *, /) plus l'opérateur 
modulo (%). Excepté pour la division, si les opérandes sont entiers, le résultat est de type 
BIGINT 64 bits. Si un seul des opérandes comporte l'option UNSIGNED, le résultat a aussi 
cette propriété UNSIGNED. En cas de dépassement de la capacité du type BIGINT, le résultat 
est 0. Le résultat de la division par zéro a la valeur NULL, et l'opération ne provoque pas 
d'erreur visible. 
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Les fonctions mathématiques 

MySQL gère un grand nombre de fonctions mathématiques classiques, telles que celles 
que vous avez définies dans la partie spécifique de PHP (voir chapitre 2). 

Le tableau 14-10 récapitule les fonctions mathématiques utilisables dans des requêtes. 



Tableau 14-10 - Fonctions mathématiques 



Fonctions 




Description 


-X 




Opposé de X 


ABS(X) 




Valeur absolue de X 


ACOS(X) 




Angle en radian dont le cosinus est X. 


ASIN(X) 




Angle en radian dont le sinus est X. 


ATAN(X) 




Angle en radian dont la tangente est X. 


ATAN2(X.Y) 




Angle en radian dont la tangente est la valeur de X/Y. 


CEILING(X) 




Arrondi à l'entier supérieur à X 


COS(X) 




Cosinus de X en radian 


COT(X) 




Cotangente de X en radian 


DEGREES(X) 




Convertit X de radian en degré. 


EXP(X) 




Exponentielle de base e de X 


FLOOR(X) 




Arrondi à l'entier inférieur à X 


GREASTEST(X 


.Y,...) 


Retourne la plus grande valeur de la liste. Utilisable avec des nombres et des lettres. 


LEASKX.Y, . 


..) 


Retourne la plus petite valeur de la liste. Utilisable avec des nombres et des lettres. 


LOG(X) 




Logarithme népérien de X 


LOGIO(X) 




Logarithme de base 1 0 de X 


MOD(X,N) 




Module : reste de la division de X par N (équivalent de X^N) 


RIO 




Valeur de pi 


POWX.Y) ou 


POWER(X,Y) 


Nombre X à la puissance Y (X et Y peuvent être décimaux). 


RADIANS(X) 




Convertit X de degré en radian. 


RANDO ou RAND(N) 


Retourne un nombre aléatoire compris entre 0 et 1 . Si le paramètre N est précisé, 
ce nombre est utilisé pour initialiser le générateur aléatoire. À chaque valeur de N 
correspond un nombre unique toujours identique. 


ROUND(X) 




Arrondit à l'entier le plus proche. 


SIGN(X) 




Retourne - 1 , 0 ou 1 selon que X est négatif, nul ou positif. 


SIN(X) 




Sinus de X exprimé en radian 


SQRT(X) 




Racine carrée de X, qui doit être positive. 


TAN(X) 




Tangente de X exprimée en radian 


TRUNCATE(X, 


N) 


Arrondit X avec N décimales. 
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Les fonctions statistiques 

Ces fonctions opèrent sur les données d'une même colonne. Elles retournent des résultats 
calculés sur l'ensemble des valeurs non NULL correspondant à cette colonne. Il est possi- 
ble de combiner plusieurs fonctions statistiques à condition d'utiliser la clause GROUP BY, 
que nous détaillons à la section suivante. 

Le tableau 14-11 récapitule les fonctions statistiques utilisables dans des requêtes MySQL. 
Tableau 14-11 - Fonctions statistiques 



Fonction 


Description 


AVG(colonne) 


Retourne la moyenne des valeurs de la colonne précisée. 


COUNT(colonne) 


Retourne le nombre de lignes dont la valeur n'est pas NULL dans la colonne 
précisée. COU NT ( * ) retourne le nombre total de lignes, même si certaines ont la 
valeur NULL. 


COUNKDISTINCT colonne) 


Retourne le nombre de lignes ayant une valeur non NULL et distincte (en élimi- 
nant les doublons). 


MAX(colcnne) 


Retourne la valeur maximale de la colonne précisée. 


MIN(colonne) 


Retourne la valeur minimale de la colonne précisée. 


SUM(colcnne) 


Retourne la somme des valeurs de la colonne précisée. 



Exemples 

Pour calculer l'âge moyen des clients : 
I SELECT AVG(age)FROM client 
Vous obtenez la valeur 32.8182. 

Pour calculer le nombre de clients ayant indiqué leur adresse e-mail (donc le nombre de 
lignes pour lesquelles la colonne mail n'est pas NULL) : 

■ SELECT COUNT(mail)FROM client 

Vous obtenez la valeur 9, alors qu'il y a 11 clients dans la table. 
Pour calculer le nombre total de clients : 
I SELECT COUNT(nom)FROM client 

Vous obtenez la valeur 11. Vous auriez pu appliquer la fonction COUNTO à n'importe 
quelle colonne ayant l'attribut NOT NULL et obtenir le même résultat. 

Pour calculer le nombre de villes différentes de la table cl ient : 

I SELECT COUNTCDISTINCT ville)FROM client 

Vous obtenez la valeur 7. 

Pour déterminer le prix maximal de la table arti cl e : 
I SELECT MAX(prix)FROM article 
Vous obtenez la valeur 2399.00. 
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Pour déterminer l'âge du client le plus jeune : 
I SELECT MIN(age)FROM client 
Vous obtenez la valeur 18. 

Pour calculer le nombre total d'articles commandés : 
I SELECT SUM(quantite)FROM ligne 
Vous obtenez la valeur 51. 

Le regroupement 

La clause GROUP BY utilisée dans une commande SELECT permet de regrouper des lignes 
ayant une caractéristique commune. Vous obtenez de la sorte des sous-ensembles de 
lignes de la table auxquels vous pouvez appliquer des opérations telles que les fonctions 
statistiques détaillées précédemment. Les calculs sont effectués sur ces sous-ensembles. 

Vous pouvez, par exemple, regrouper les clients par ville en écrivant la clause ' GROUP BY 
ville'. Au lieu de calculer l'âge moyen de la totalité des clients, vous pouvez ainsi calcu- 
ler l'âge moyen des clients par ville. 

La requête suivante : 

I SELECT AVG( âge ) AS 'âge moyen', ville FROM client GROUP BY ville 

affiche le résultat ci-dessous, dans lequel l'utilisation d'un alias pour la colonne AVG(age) 
donne une information plus lisible en remplaçant le nom de la colonne âge par le texte âge 
moyen. 



âge moyen 


ville 


22.0000 


Chartres 


18.0000 


Lille 


48.5000 


Lyon 


37.0000 


Nantes 


38.0000 


Orléans 


29.3333 


Paris 


45.0000 


Versailles 



Les exemples précédents d'utilisation de fonctions statistiques n'utilisaient pas la clause 
GROUP BY. Il n'était donc pas possible de sélectionner plusieurs colonnes dans une même 
requête. Avec cette clause, vous pouvez regrouper les lignes par ville et afficher dans un 
même tableau l'âge minimal, l'âge moyen et l'âge maximal des clients. 

Par exemple, la requête suivante : 

SELECT MIN(age) AS 'Age minimum' ,AVG(age) AS 'Age moyen', MAX(age) AS 
^'Age maximum' , ville 
FROM client 
GROUP BY ville 

retourne le tableau illustré à la figure 14-19. 
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Age minimum 


Age moyen 


Age maximum 


ville 


22 


22.0000 


22 


Chartres 


18 


18.0000 


18 


Lille 


45 


48.5000 


52 


Lyon 


37 


37.0000 


37 


Nantes 


36 


36.0000 


36 


Orléans 


19 


29.3333 


44 


Paris 


45 


45.0000 


45 


Versailles 



Figure 14-19 

Calculs statistiques sur les âges 



Exemple 

Pour afficher le montant total et le nombre d'articles de chaque commande, vous allez 
utiliser la colonne id_comm comme critère de regroupement. En appliquant la fonction 
SUM( ), vous pouvez calculer le prix de chaque ligne puis le total : 

SELECT id_coinin AS 'Numéro de cominande', 

SUM( prixunit * quantité ) AS 'Prix Total', SUM(quantite) AS 'Nombre d\'articles' 
FROM ligne 
GROUP BY id_comm 

La requête affiche le résultat illustré à la figure 14-20. 



Numéro de commande 


Prix Total 


Nombre d'articles 


1 


1709.70 


4 


2 


3000.00 


2 


3 


2395.00 


S 




7232.00 




5 


329.00 


1 


6 


1570.70 


4 


7 


9995.00 


5 


8 


3889.00 


2 


9 


269.00 


1 


10 


5429.00 


3 


11 


175.00 


10 


12 


4994.60 


7 


13 


3998.00 


2 



Figure 14-20 

Calcul du prix total par commande 
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Dans un regroupement, vous pouvez indiquer une condition de restriction des lignes, 
comme dans une requête de sélection habituelle. Vous utilisez pour cela la clause HAVING, 
qui est l'équivalent de la clause WHERE mais n'est utilisée qu'après une clause GROUP BY. 
Les conditions écrites dans HAVING peuvent utiliser les mêmes opérateurs et fonctions que 
celles écrites dans WHERE. 

Par exemple, pour calculer l'âge moyen des clients qui habitent des villes dont l'initiale 
est L, vous ajoutez une condition de restriction HAVING à l'aide de l'opérateur LIKE après la 
clause GROUP BY. 

La requête suivante : 

SELECT AVG( âge ), ville 
FROM client 
GROUP BY ville 
HAVING ville LIKE ■L%' 

affiche le résultat ci-dessous : 



AVG( âge ) 


Ville 


18.0000 


Lille 


48.5000 


Lyon 



Les jointures 

Faire une jointure consiste à effectuer une sélection de données sur plusieurs tables. Il 
faut pour cela que les tables concernées par la jointure aient au moins chacune une 
colonne contenant un même type d'information. C'est le cas des tables cl ient et commande 
de la base magasin, qui ont en commun la colonne id_client. La commande SELECT peut 
donc s'appliquer, avec une condition WHERE, à cette colonne. 

La syntaxe la plus courante d'une jointure est la suivante : 

SELECT coll,col2.... 
FROM tablel,table2,... 
WHERE condition_de_jointure 

La condition de jointure est de la forme : 

I tablel.colX = table2.colY 

dans laquelle colX et col Y contiennent des données représentant la même information, 
comme l'identifiant de client. 

Jointure de deux tables 

L'association entre un numéro de commande et le nom d'un client fait intervenir les 
tables client et commande. Pour retrouver toutes les commandes faites par un client, vous 
opérez une jointure entre ces tables en utilisant la colonne id_cl ient commune aux deux 
tables. 
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La requête suivante : 

I SELECT commande. id_coinm,noni,prenoni,vil le 
FROM commande, 'client' 
WHERE client. id_client = commande. i d_cl ient ORDER BY nom 

affiche le résultat illustré à la figure 14-21 (la clause ORDER BY trie les noms par ordre 
alphabétique). 



id_comm 


nom 


prénom 


ville 


2 


Basile 


Dîd 


Nantes 


S 


Basile 


Did 


Nantes 


13 


Basile 


Did 


Nantes 


6 


Darc 


Jeanne 


Paris 


4 


Devos 


Marie 


Lille 


9 


Gâté 


Bill 


Lyon 


12 


Grave 


Nuyen 


Lille 


1 


Grave 


Nuyen 


Lille 


10 


Hochon 


Paul 


Chartres 


1^ 11 


Mac Neal 


John 


Lyon 


3 


Marti 


Jean 


Orléans 


8 


Marti 


Pierre 


Paris 


7 


Rapp 


Paul 


Paris 



Figure 14-21 

Jointure sur les tables client et commande 



La condition WHERE peut comporter d'autres composantes permettant d'opérer une sélec- 
tion plus précise. 

Par exemple, pour sélectionner les commandes du client dont l'identifiant est 5, vous 
ajoutez la condition suivante à la clause WHERE : 

I SELECT commande. id_comm, client.id_client FROM commande, cl ient 
WHERE client.id_client = commande. id_cl ient AND client.id_client =5 

Cette requête affiche le résultat ci-dessous : 



id_comm 


id_client 


date 


1 


5 


2004-06-11 


12 


5 


2005-02-01 



Il est possible d'utiliser la clause GROUP BY dans une jointure pour effectuer des calculs 
statistiques sur un groupe de données. 



424 



PHP 5 



Dans l'exemple suivant, vous cherchez à établir la liste des articles les plus vendus sur le 
site et à afficher leur code, leur désignation, leur prix et le nombre total d'articles. Vous 
effectuez pour cela une jointure sur les tables a rti cl e et 1 i gne en utilisant comme critère 
de jointure leur colonne commune id_article. Vous appliquez ensuite à la colonne id_ 
arti cl e la clause GROUP BY pour obtenir la somme des ventes de chaque article et la clause 
ORDER BY pour afficher les résultats en ordre décroissant : 

I SELECT article. id_article, désignation, prix SUM( quantité ) AS 'Total' 
FROM article, ligne 
WHERE arti cl e. id_arti cl e = ligne. id_article 
GROUP BY id_article 
ORDER BY Total DESC 

La requête affiche le résultat illustré à la figure 14-22. 



id_article 


désignation 


prix 


Total 


DVD75 


DVD vierge par 3 


17.50 


12 


CAS07 


Cassette DV60 par 5 


26.90 


10 


SAX15 


Portable Samsung XI 5 XVM 


1999.00 


6 


CS330 


Caméscope Sony DCR-PC330 


1629.00 


4 


SOXMP 


PC Portable Sony Z1-XMP 


2399.00 


4 


HP497 


PC Bureau HP497 écran TFT 


1500.00 


2 


CP100 


Caméscope Panasonic SV-AV 1 00 


1490.00 


2 


DEL30 


Portable Dell X300 


1715.00 


2 


NIK55 


Nikon F55+zoom 2SI80 


269.00 


1 


CA300 


Canon EOS 3000V zoom 28/80 


329.00 


1 



Figure 14-22 

Jointure et groupement 

Jointure de plus de deux tables 

Les jointures peuvent porter sur plus de deux tables, à condition que les tables jointes 
contiennent un même type de donnée dans une de leurs colonnes. 

L'exemple suivant est d'une forme plus complexe que les précédents car il opère successi- 
vement une jointure sur les tables commande et cl i ent ayant en commun la colonne i d_cl i ent 
et une jointure sur les tables commande et ligne ayant en commun la colonne id_comm. 
Ces jointures permettent tout à la fois de sélectionner les numéros des commandes, 
les nom, prénom et ville du client associé à la commande et le montant total de la 
commande obtenu et de regrouper les résultats par numéro de commande à l'aide de 
la clause GROUP BY. 
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Le tri des données est effectué par le nom des clients de façon à voir d'un coup toutes les 
commandes d'un même client : 

SELECT commande. id_coinm, nom, prénom, ville, sum( quantité * prixunit ) 

^AS 'Prix total ' 

FROM commande, 'client' , ligne 

WHERE client.id_client = commande. i d_cl ient AND commande. id_comm = 1 igne. id_comm 
GROUP BY id_comm 
ORDER BY nom 

La requête affiche le résultat illustré à la figure 14-23. 



id_comm 


nom 


prénom 


ville 


Prix total 


5 


Basile 


Did 


Nantes 


329.00 


13 


Basile 


Did 


Nantes 


3998.00 


2 


Basile 


Did 


Nantes 


3000.00 




Darc 


Jeanne 


Paris 


1570.70 


4 


Devos 


Marie 


Lille 


7232.00 


9 


Gâté 


Bill 


Lyon 


289.00 


12 


Grave 


Nuyen 


Lille 


4994.60 


1 


Grave 


Nuyen 


Lille 


1709.70 


10 


Hochon 


Paul 


Chartres 


5429.00 


11 


Mac Neal 


John 


Lyon 


175.00 


3 


Marti 


Jean 


Orléans 


2395.00 


8 


Marti 


Pierre 


Paris 


3889.00 


7 


Rapp 


Paul 


Paris 


9995.00 



Figure 14-23 

Jointure sur trois tables 



Exercices 

Exercice 1 

Créez une base nommée voitures. Créez ensuite les tables de la base voitures selon le 
modèle logique défini dans les exercices du chapitre 13. Omettez volontairement certaines 
colonnes, et faites quelques erreurs de type de colonne. Une fois les tables créées, ajoutez 
les colonnes manquantes, et corrigez les erreurs. Vérifiez la structure de chaque table. 

Exercice 2 

Exportez les tables de la base voitures dans des fichiers SQL. 
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Exercice 3 

Supprimez toutes les tables de la base voitures. 
Exercice 4 

Recréez les tables de la base voitures en utilisant les fichiers SQL précédents. 
Exercice 5 

Insérez des données dans la table propriétaire de la base voitures, puis vérifiez-en la 
bonne insertion. 

Exercice 6 

Créez un fichier texte contenant une liste de modèles de voitures avec autant de données 
par ligne que de colonnes dans la table modèle de la base voitures. Insérez ces données 
dans la base. 

Exercice 7 

Créez un fichier Excel ou OpenOffice contenant une liste de modèles de voitures avec 
autant de données par ligne que de colonnes dans la table model e. Enregistrez-le au format 
CSV, et insérez les données dans la base. 

Exercice 8 

Insérez des données dans les autres tables de la base voitures. Effectuez des mises à jour 
en modifiant certaines valeurs. 

Exercice 9 

Dans la base magasi n, sélectionnez les articles dont le prix est inférieur à 1 500 euros. 
Exercice 10 

Dans la base magasin, sélectionnez les articles dont le prix est compris entre 100 et 
500 euros. 

Exercice 1 1 

Dans la base magasin, sélectionnez tous les articles de marque Nikon (dont la désignation 
contient ce mot). 

Exercice 12 

Dans la base magasin, sélectionnez tous les caméscopes, leur prix et leur référence. 
Exercice 13 

Dans la base magasin, sélectionnez tous les produits de la catégorie informatique, et affi- 
chez leur code, leur désignation et leur prix par ordre décroissant de prix. 

Exercice 14 

Dans la base magasin, sélectionnez tous les clients de moins de 40 ans, et ordonnez les 
résultats par ville en ordre alphabétique. 
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Exercice 15 

Dans la base magasin, calculez le prix moyen de tous les articles. 
Exercice 16 

Dans la base magasin, calculez le nombre d'e-mails non NULL et distincts l'un de l'autre. 
Exercice 17 

Dans la base magasin, affichez les coordonnées des clients ayant la même adresse (même 
adresse et même ville). 

Exercice 18 

Dans la base magasin, sélectionnez tous les articles commandés par chaque client. 
Exercice 19 

Dans la base magasin, sélectionnez tous les clients dont le montant d'une commande 
dépasse 1 500 euros. 

Exercice 20 

Dans la base magasin, sélectionnez tous les clients dont le montant total de toutes les 
commandes dépasse 5 000 euros. 

Exercice 21 

Dans la base voitures, sélectionnez tous les véhicules d'une personne donnée. 
Exercice 22 

Dans la base voitures, sélectionnez toutes les personnes ayant le même modèle de 
voiture. 

Exercice 23 

Dans la base voitures, sélectionnez tous les véhicules ayant plusieurs copropriétaires. 



15 

Accès procédural à MySQL 

avec PHP 



Ayant acquis au chapitre précédent une maîtrise des commandes SQL, vous pouvez abor- 
der les fonctions PHP permettant d'accéder à une base MySQL à partir d'un script PHP, 
d'y insérer des données et d'utiliser ces données pour créer des pages dynamiques. 

Pour que la base de données MySQL soit accessible à partir des pages d'un site, il faut 
pouvoir l'utiliser par l'intermédiaire d'un script. MySQL est utilisable par d'autres 
langages que PHP, Java par exemple. Le couple PHP-MySQL est cependant le plus 
répandu sur le Web. 

L'accès à une base MySQL et son utilisation, qu'il s'agisse d'insérer, de modifier ou de 
lire des données, suit les étapes ci-dessous : 

1. Connexion au serveur MySQL. 

2. Envoi de diverses requêtes SQL au serveur (insertion, lecture, suppression ou mise à 
jour des données). 

3. Récupération du résultat d'une requête. 

4. Fermeture de la connexion au serveur. 

Le présent chapitre montre comment effectuer ces étapes au moyen des nombreuses 
fonctions proposées par l'extension mysql dont vous pouvez vérifier la présence au 
moyen de la fonction phpinfo( ). Celle-ci donne accès à MySQL de manière procédurale. 
Les chapitres suivants sont consacrés à l'accès à MySQL au moyen d'objets. 
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Connexion au serveur MySQL 

Avant toute chose, le script doit permettre de se connecter au serveur MySQL. La fonc- 
tion essentielle de ce script est mysql_connect( ), dont la syntaxe est la suivante : 

I resource inysql_connect (string $host , string $user , string $pass [, bool $multi]) 

$host est une chaîne contenant le nom du serveur. Ce dernier est défini par l'hébergeur du 
site et est communiqué lors de la souscription de l'abonnement. Il s'agit le plus souvent 
de la chaîne "local host", comme ce sera le cas dans tous les exemples de ce chapitre, 
réalisés en local avec Wampserver. 

$user est le nom sous lequel l'utilisateur est autorisé à accéder au serveur. Il s'agit 
généralement du nom de domaine ou du login pour les hébergements gratuits. Dans 
Wampserver, la valeur par défaut de ce paramètre est "root". $pass est le mot de passe 
associé à l'utilisateur. Si plusieurs utilisateurs sont autorisés à accéder au serveur, chacun 
doit posséder un identifiant et un mot de passe personnel. Sur un serveur local, il s'agit 
par défaut d'une chaîne vide. 

$mul ti est un booléen. S'il vaut TRUE, deux appels de mysql_connect( ) avec des paramètres 
identiques dans un même script créent deux connexions différentes. 

Par mesure de sécurité, vous avez tout intérêt à placer les valeurs des paramètres de 
connexion dans un fichier séparé, en prenant soin d'y définir ces paramètres sous forme 
de constantes. Vous pouvez ensuite l'inclure dans les scripts de création de connexions 
utilisant les noms de ces constantes. Le fichier myparam.inc.php de l'exemple 15-1 réalise 
cette opération avec ici les paramètres du serveur local. Vous l'utiliserez systématique- 
ment par la suite. 

f*' Exemple 1 5-1 . Le fichier myparam.inc.php 

<?php 

def i ne( "MYHOST" . "1 ocal host" ) ; 

define("MYUSER"."root"): 

define("MYPASS".""): 

?> 

La fonction mysql_connect( ) retourne une variable de type resource, qui est un identifiant 
de connexion. Il faut récupérer cette valeur dans une variable car elle est utilisée pour 
effectuer les opérations suivantes sur la base. L'identifiant est noté systématiquement 
Sidcomm dans les exemples de ce chapitre. Si la connexion n'est pas établie, la fonction 
retourne FALSE. Vous devez donc tester la réussite de la connexion avant d'effectuer 
d'autres opérations. 

La connexion au serveur peut également être établie à l'aide de la fonction mysql_ 
pconnectO, qui requiert les mêmes paramètres que mysql_connect( ) mais établit une 
connexion persistante. Certains hébergeurs interdisant l'usage de cette fonction, vous ne 
l'utiliserez pas dans ces exemples. 

La connexion établie prend fin automatiquement quand le script PHP est terminé. Il est 
cependant recommandé d'y mettre fin explicitement dès que possible de façon à libérer 
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le serveur MySQL. Le script peut en effet réaliser toutes sortes d'opérations qui ne néces- 
sitent pas de connexion. Cette précaution améliore la vitesse des connexions des autres 
utilisateurs. 

Pour mettre fin à la connexion, vous appelez la fonction mysql_close( ), dont la syntaxe 
est la suivante : 

I boolean mysql_close([$idcom]) 

Le paramètre $idcom est l'identifiant de connexion récupéré lors de la connexion. S'il est 
omis, c'est la dernière connexion utilisée qui est fermée. Une connexion persistante ne 
peut être fermée par la fonction mysql_cl ose( ). 

Si le serveur comporte plusieurs bases de données, le script précise la base désirée au 
moyen de la fonction mysql_sel ect_db( ), dont la syntaxe est la suivante : 

I boolean mysql_select_db($nom_base [,$idcom]) 

Cette fonction retourne TRUE si la base existe et FALSE dans le cas contraire. Après l'appel 
de cette fonction, toutes les requêtes SQL envoyées au serveur MySQL sont effectuées 
sur la base choisie, sans qu'il soit besoin de le préciser. 



La commande USE 

Vous pouvez utiliser à la place de la fonction PHP mysql_select_db{ ) la commande SQL USE, selon la 
syntaxe USE nom„base, en passant la chaîne "USE nom_base" comme paramètre à la fonction mysql_ 
query( ), détaillée à la section suivante. 



Si le script effectue de nombreuses opérations entre deux requêtes, il est bon de vérifier 
que la connexion est toujours active. Le serveur met fin à une connexion après un délai 
défini par défaut dans le fichier php. i ni à trente secondes sur Wampserver et variable 
selon l'hébergeur du site. 

Vous disposez de la fonction mysql_ping( ) pour vérifier que la connexion est active. La 
syntaxe de cette fonction est la suivante : 

I boolean iiiysql_ping( resource $idcoin) 

La fonction retourne TRUE si la connexion est active et FALSE dans le cas contraire. Si la 
connexion est fermée, il y a automatiquement reconnexion au serveur avec les paramè- 
tres utilisés par la fonction mysql_connect( ). 

La structure d'un script accédant au serveur MySQL est la suivante : 
<?php 

//Inclusion des paramètres de connexion 
incl ude_once("myparam.inc.php") ; 

//Connexion au serveur 

$idcom=@mysql_connect(MYHOST,MYUSER,MYPASS); 
//Choix de la base 
$idbase=@mysql_select_db($base) ; 
//Affichage d'un message en cas d'erreurs 
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if( !$idcom| !$idbase) 
{ 

echo "<script type=text/javascript>" ; 

echo "alert( 'Connexion Impossible à la base $base' )</script>" ; 

} 

^■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//Requêtes SQL sur la base choisie 

/ /k-kkkkkkkk-k-kk-k-kkk-k-kkk-k-kkk-k-kkk-k-kkk 

//Fermeture de la connexion 

mysql_close($idcom) ; 

?> 

Lorsque les scripts du site doivent accéder fréquemment au serveur MySQL, vous avez 
intérêt à créer une fonction spécialisée, dont l'appel évite de réécrire ces parties de code. 
L'exemple 15-2 crée une telle fonction en utilisant deux paramètres, $base, qui est le nom 
de la base à laquelle vous souhaitez accéder, et $param, qui est le nom du fichier contenant 
les paramètres de connexion sans les extensions .inc. php. Elle peut être utilisée dans 
plusieurs sites différents car elle est indépendante aussi bien du nom du serveur que de 
celui de la base. 

La fonction inclut d'abord les paramètres de connexion (repère O) puis appelle la fonc- 
tion mysql_connect( ) en utilisant ces paramètres (repère©). Elle sélectionne ensuite la 
base (repère©) et gère les erreurs éventuelles de connexion ou d'accès à la base 
(repère ©) en affichant une boîte d'alerte en JavaScript (repère 0). La fonction retourne 
enfin l'identifiant de connexion $idcom (repère ©). L'utilisation du caractère @ devant le 
nom des fonctions permet d'éviter l'affichage des éventuels messages d'erreur sur la page. 

'•^ Exemple 15-2. Fonction de connexion au serveur 

<?php 

function connex($base,$param) 
{ 

incl ude_once($param. " . inc. php" ) ; <— O 
$idcom=@mysql_connect(MYHOST,MYUSER.MYPASS); <-© 
$idbase=@mysql_select_db($base) ; <— © 
if(!$idcom | !$idbase) <— © 
{ 

echo "<script type=text/javascript>" ; <— © 

echo "alert( 'Connexion Impossible à la base Sbase' )</script>" ; 

) 

return $idcom; <— © 

} 

?> 

Chacun de vos scripts d'accès à une base de données doit donc contenir les lignes de code 
suivantes, qui permettent d'utiliser la fonction connex( ) après avoir inclus son code : 

Iincl ude( "connex. inc.php" ) ; 
$idcom=connex( "nomjase" , "myparam" ) ; 

Cela allège d'autant chacun des scripts. 
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Envoi de requêtes SQL au serveur 

Toute opération à réaliser sur une base nécessite d'envoyer au serveur une requête SQL 
rédigée à l'aide des commandes détaillées au chapitre précédent. 

Pour envoyer une requête, vous utilisez d'abord la fonction mysql_query( ), dont la syntaxe 
est la suivante : 

I resource mysql_qLiery(string $reqLiete [.resource $idcom][,int mode]) 

La chaîne $ requête contient le code de la requête SQL. Elle ne doit pas se terminer par un 
point- virgule. Les requêtes étant souvent longues, il est recommandé, à des fins de lisibi- 
lité du code, de les écrire dans une variable chaîne $ requête passée ensuite à la fonction. 

$idcom est l'identifiant de connexion. Il est facultatif si une seule connexion est ouverte, 
mode est une constante entière, qui prend les valeurs MYSQL_STORE_RESULT (valeur par 
défaut) si le résultat de la requête doit être mis en buffer (mémoire tampon sur le serveur) 
et MYSQL_USE_RESULT dans le cas contraire. Dans ce dernier cas, il faut lire le résultat avant 
d'envoyer une nouvelle requête au serveur, faute de quoi le résultat est perdu. 

La fonction retourne un identifiant de résultat de type resource, noté systématiquement 
$result dans ces exemples. Si la requête contient des commandes SELECT, cet identifiant 
permet d'accéder aux données fournies par la requête en utilisant certaines fonctions PHP 
que vous découvrirez plus loin dans ce chapitre. Pour les autres requêtes (suppression, 
modification, mise à jour), la fonction retourne TRUE si la requête est bien exécutée. Si une 
requête quelconque n'est pas exécutée, la fonction mysql_query( ) retourne FALSE. Il est 
recommandé d'effectuer un test pour vérifier la bonne réalisation de chaque requête SQL 
dans un script. 

Un script d'envoi de requête a la forme suivante : 
<?php 

incl ude( "connex. inc.php" ) ; <— O 

$idcom=connex( "magasin" , "myparam" ) ; <— 0 

$requete="SELECT * FROM article ORDER BY catégorie" ; <—0 

$result=@mysql_query($requete,$idcom) ; <— O 

if( !$result) 

{ 

echo "Lecture impossible"; <—0 

} 

el se 
{ 

//Lecture des résultats éventuels de la requête^© 
} 

?> 

II effectue successivement l'inclusion du fichier connex. inc. php (repère O), la connexion 
au serveur grâce à la fonction connexO (repère ©), l'écriture de la requête (repère 0), 
l'envoi de la requête et la récupération du résultat (repère 0) et enfin l'affichage d'un 
message d'erreur éventuel si la requête n'a pas abouti (repère 0) et celui des résultats de 
la requête (repère 0). Nous verrons, dans les sections suivantes, comment afficher les 
résultats d'une requête de sélection. 



434 



PHP 5 



Lecture du résultat d'une requête 

Pour les opérations d'insertion, de suppression ou de mise à jour de données dans une 
base, il est simplement utile de vérifier si la requête a bien été exécutée. 

Par contre, lorsqu'il s'agit de lire le résultat d'une requête contenant la commande SELECT, 
il est indispensable de recueillir les données. PHP offre une grande variété de fonctions 
qui permettent de récupérer des données sous des formes diverses, la plus courante étant 
un tableau. Chacune de ces fonctions ne récupérant qu'une ligne du tableau à la fois, il 
faut recourir à une ou plusieurs boucles pour lire l'ensemble des données. 

Lecture à l'aide d'un tableau 

La fonction la plus perfectionnée pour lire les données dans un tableau est mysql_fetch_ 
array( ). Sa syntaxe est la suivante : 

I array mysql_fetch_array( resource Sresult [,int typetab]) 

Cette fonction retourne un tableau contenant autant d'éléments qu'il y a de colonnes 
précisées dans la requête SELECT. Le paramètre $result est celui qui a été retourné par la 
fonction mysql_query( ), et le paramètre typetab une constante entière précisant si le 
tableau retourné doit être associatif (valeur MYSQL_ASSOC), indicé (valeur MYSQL_NUM) ou les 
deux à la fois (valeur MYSQL_BOTH, qui est la valeur par défaut). Si le tableau est associatif, 
les clés du tableau sont les noms des colonnes de la table interrogée ou des alias, si vous 
en avez définis dans la requête. Il n'est donc pas nécessaire de connaître l'ordre des 
colonnes dans la table. 

Si le tableau est indicé, l'indice d'un élément est celui de la colonne dans la requête, la 
première colonne ayant l'indice 0. Pour récupérer la valeur d'une colonne précise, il est 
indispensable de connaître sa position dans la requête. 

Chaque nouvel appel de la fonction mysql_fetch_array( ) retourne la ligne suivante du 
résultat identifié par $result, ou FALSE s'il n'y a plus de ligne à lire. Il faut effectuer une 
boucle pour lire chacune des lignes puis une autre boucle imbriquée dans la première 
pour lire chacune des valeurs des colonnes de la table. 



Nombre de lignes et de colonnes d'un résultat 

La fonction int mysql_num_fields( resource Sidresult) permet de déterminer le nombre de 
colonnes du résultat et la fonction int mysql_nuni_rows( resource $idresult) le nombre de lignes. 



L'exemple 15-3 met en pratique les techniques que vous venez d'aborder en effectuant la 
lecture de la table article de la base magasin créée au chapitre 14. Après l'appel de la 
fonction de connexion (repère O), l'écriture de la requête SQL (repère ©) et son envoi 
au serveur, le résultat est identifié par la variable $result (repère ©). Le script contrôle 
ensuite si le résultat est valide (repère Q) et lit le nombre de colonnes et de lignes 
retourné par la requête (repère 0 et ©). La première boucle whi 1 e de lecture du résultat 
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retourne une ligne à la fois dans un tableau indicé (repère Q), puis une boucle foreach lit 
chacune des valeurs du tableau et réalise un affichage dans un tableau XHTML 
(repère ©). La ressource $resul t est ensuite libérée (repère Q). 



Libération de la mémoire 

Une fois les données utilisées pour réaliser un affichage dans une page XHTIVIL, il est possible de libérer 
la mémoire occupée par la variable $resul t en appelant la fonction niysql_f ree_resul t ($ resuit). 
Cette dernière retourne TRUE en cas de réussite et FALSE dans le cas contraire. Cette opération ne doit 
être faite que si vous n'avez plus besoin des données dans le script. 



La figure 15-1 illustre la page réalisée par ce script. 
'•^ Exemple 15-3. Lecture de la table article 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<titl e>Lecture de la table article</title> 
<style type="text/css" > 

table {border-style:double;border-width:3px; border-col or :red: 

^backg round -col or:yel 1 ow; } 

</style> 

</head> 

<body> 

<?php 

incl ude( "connex. inc.php" ) ; 
$idcom=connex( "magasin" , "myparam" ) ; <— O 
$requete="SELECT * FROM article ORDER BY catégorie" ; <—0 
$result=@mysql_query($requete,$idcom) ; <— © 
if(!$result) <-© 
{ 

echo "Lecture impossible"; 

} 

el se 
{ 

$nbcol=mysql_num_fields($result) ; <— © 
$nbart=mysql_num_rows($result) ; <— © 
echo "<h3> Tous nos articles par catégorie</h3>" ; 
echo "<h4> Il y a $nbart articles en magasin </h4>": 
echo "<table border=\"l\"><tbody>" ; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 
^<th>Catégorie</th></tr>"; 

while($ligne=mysql_fetch_array($result,MYSQL_NUM)) <— © 
{ 

echo "<tr>"; 

foreach($ligne as Svaleur) <— © 
{ 
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echo "<td> $valeur </td>": 

} 

echo "</tr>": 

} 

echo "</tbody></table>": 

} 

niysql_f ree_result($result) ; <— © 
?> 

</body> 
</html> 



3 Lecture de la table article - Microsoft Internet Explorer ElBH 



Fichief Edition Affichaïae Favoris OAk ? îf 
Q Précédente ' Q - ^ JDnaûïentia '^Hmns (jf" Média 

Max j^liU|j;/;i27.0.0.1ftjltJ5/CI5lliy^lliyiqte>2.|]lip ^ Q OK 

Tous nos articles par catégorie 



By a 11 articles en magasin 



Code article 


Description 


Prix Catégorie 


|CS330 


Caméscope Sony DCR-PC330 


1629 00 vidéo 


ICPlOO 


ICaméiïcope Panasonic SV-AV 100 1490 00 vidéo 


|NIK55 


Nikon F55+zoom 28/80 


2«9.00 photo 


^SO 


Nikon F80 


,479 00 photo 


|CA300 


Canon EOS 3000V loom 28/80 


329.00 Iphoto 


IsOXMP 


^PC Portable Sony ZI -XMP 


2399.00 infoimalique 


Ihmw 


iPC Bureau HP497 écran TFT 


1300 00 informatique 


lDBl.30 


iPortableDellWUO 


IVli.OO intbnnatique 


|SAX15 


PnrtaHe Samsung XI 5 XVM 


|l999 00 mfontiali(]Ui! 


|DVD75 


DVD uierge par 3 


Î17.50 |diw« 


jcAS07 


jCassette DV60 par 5 


|2£.90 Idiven; 



^ Temilni # Intecnet 

Figure 15-1 

Lecture de la table article 

Les deux autres fonctions suivantes permettent de récupérer une ligne de résultat à la fois 
dans un tableau : 

• array mysql_fetch_assoc( resource Sresult), qui retourne un tableau uniquement asso- 
ciatif dont les clés sont les noms des colonnes de la table interrogée. 

• array mysql_fetch_row( resource $ resuit), qui retourne un tableau uniquement indicé 
dont les indices sont les numéros des colonnes dans la table interrogée. 

Ces fonctions peuvent s'utiliser en lieu et place de mysql_fetch_array( ) avec la même 
rapidité. 
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Lecture des noms de colonnes 

Si vous choisissez de récupérer les lignes du résultat dans un tableau associatif, vous 
pouvez lire les noms des colonnes pour les afficher dans la page XHTML. Si vous utili- 
sez de plus des alias dans la requête SQL, vous pouvez donner aux noms des colonnes 
des titres plus significatifs que idjrticle sans avoir à les écrire explicitement dans le 
code de création du tableau XHTML, à la différence de l'exemple précédent. 

Il existe deux méthodes pour lire les noms des colonnes d'une table. 



Première méthode 

L'exemple 15-4 illustre une requête SQL sélectionnant tous les articles de marque Sony en 
définissant des alias pour les noms de colonnes (repère O). Après l'envoi de la requête par 
la fonction mysql_query( ) (repère ©), un premier appel à la fonction mysql_fetchjrray( ) 
lit la première ligne du résultat dans un tableau associatif (repère 0). Une boucle f oreach 
lit les clés du tableau obtenu et affiche les titres des colonnes du tableau (repère O)- 

A ce stade, la variable $ligne contient la première ligne de résultat, mais vous n'avez 
utilisé que les clés de ce tableau, qui sont les noms des colonnes. Si vous lisiez les valeurs 
des lignes avec une boucle while, comme à l'exemple précédent, un nouvel appel de la 
fonction mysql_fetch_array( ) lirait la deuxième ligne, ce qui écraserait les valeurs de 
la première ligne. L'emploi d'une boucle do.. while résout ce problème, la fonction 
mysql_fetch_array( ) n'étant appelée qu'après l'affichage des valeurs de chaque ligne 
(repères 0 et 0). 

Exemple 15-4. Récupération des noms de colonnes 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 
<titl e>Lecture de la table article</title> 
<style type="text/css" > 

table (border-style:double;border-width:3px; border-col or :red:background-col or lyellow;} 

</style> 

</head> 

<body> 

<?php 

incl ude( "connex. inc.php" ) ; 
$idcom=connex( "magasin" , "myparam" ) ; 

$requete="SELECT id_article AS 'Code article' .désignation AS 'Désignation' , prix 
^AS 'Prix Unitaire' .catégorie AS 'Catégorie' 
FROM article 

WHERE désignation LIKE '^Sony^' 
ORDER BY catégorie"; <— O 
$result=@mysql_query($requete.$idcom) ; <— 0 
if( !$result) 
{ 
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echo "Lecture impossible": 

} 

else 
{ 

$nbart=mysql_num_rows($result) ; 

$ligne=mysql_fetch_array($result.MYSQL„ASSOC); <— © 
echo "<h3> Tous nos articles de la marque Sony</h3>": 
echo "<h4> Il y a $nbart articles en magasin </h4>": 
echo "<table border=\"l\"> <tr>"; 
foreach($l igne as $nomcol=>$valcol ) <— © 
{ 

echo "<th> Snomcol </th>"; 

) 

echo "<tr>"; 

do <— 0 

{ 

echo "<tr>"; 

foreach($l igne as Svalcol) 
{ 

echo "<td> Svalcol </td>": 

) 

echo "</tr>"; 

} 

while($ligne=mysql_fetch_array($result,MYSQL_NUM)) : <— © 
echo "</table>"; 

} 

?> 

</body> 
</html> 

La figure 15-2 illustre les résultats de la requête effectuée sur la table arti cl e. 
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Figure 15-2 

Lecture des noms de colonnes 
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Deuxième méthode 

Il existe une autre méthode pour lire le nom des colonnes du résultat d'une requête 
SELECT. La fonction mysql_fielcl_name( ), dont la syntaxe est la suivante : 

I string mysql_fielcl_name(resource Sresult, int nuin_col) 

retourne le nom de la colonne ou de l' alias dont le numéro est passé en second paramètre. 
L'ordre des colonnes est celui de la requête et donc pas nécessairement celui de la table. 

L'exemple 15-5 illustre cette possibilité de lecture des noms des colonnes. La requête 
SQL sélectionne les caractéristiques des clients habitant à Paris (repère Q)- Après l'envoi 
de celles-ci (repère 0), vous récupérez le nombre de colonnes (repère ©) et de lignes 
(repère Q) du résultat. Une boucle for permet l'affichage des en-têtes du tableau 
XHTML (repère 0). La fonction mysql_field_name( ) permet de lire le nom des colonnes 
(repère ©). 

Pour afficher les valeurs sélectionnées, vous créez une boucle for (repère Q), dans 
laquelle vous lisez une ligne du résultat en appelant la fonction mysql_fetch_row( ) 
(repère©). Une autre boucle for imbriquée dans la précédente permet l'affichage de 
toutes les valeurs d'une ligne contenues dans le tableau $1 igne (repère 0). 

L'avantage de ces méthodes est d'automatiser l'écriture des en-têtes du tableau XHTML, 
et ce quel que soit le nombre de colonnes sélectionnées. Si vous ajoutez le champ mail 
dans la requête, il n'y a qu'une ligne à modifier alors qu'avec la méthode de l'exem- 
ple 15-3, il faudrait modifier tout le code de création des en-têtes. 

La figure 15-3 donne un aperçu du résultat obtenu en ajoutant simplement le champ mail 
à la requête. 

'•^ Exemple 15-5. Lecture des noms de colonnes 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtcl"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 
<titl e>Lecture de la table client</title> 
<style type="text/css" > 

table {border-style:double;border-width: 3px;border-col or: red ; 

^background-col or: yellow;} 

</style> 

</head> 

<body> 

<?php 

incl ude( "connex. inc.php" ) ; 
$idcom=connex( "magasin" , "myparam" ) ; 

$requete="SELECT id_client AS 'Code client' , nom, prénom, adresse, âge 

FROM client 

WHERE ville ='Paris' 

ORDER BY nom": <-© 

$result=@mysql_query($requete,$idcom) ; <— 0 
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if( !$result) 
{ 

echo "Lecture impossible"; 

} 

el se 
{ 

$nbcol=mysql_nuin_fields($ resuit) ; <— ^ 
$nbart=mysql_num_rows($result) ; <— ^ 
echo "<h3> Il y a $nbart clients habitant Paris</h3>"; 
//Affichage des titres du tableau 
echo "<table border=\"l\"> <tr>"; 
for($i=0:$i<$nbcol ;$i++) <— 0 
{ 

echo "<th>", mysql_f ield_naiïie($resul t ,$i ) , " </th>":<— © 

) 

echo "</tr>"; 

//Affichage des valeurs du tableau 
for($i=0;$i<$nbart;$i++) <— Q 

{ 

$1 igne=mysql_fetch_row($resul t) ; <— © 
echo "<tr>"; 

for($j=0:$j<$nbcol :$j++) <-0 
{ 

echo "<td>".$ligne[$j],"</td>"; 

) 

echo "</tr>"; 

) 

echo "</table>"; 

mysql_f ree_result($result) ; 

} 

?> 

</body> 
</html> 
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Figure 15-3 

Affichage automatique des en-têtes de tableau XHTML 
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Utilisation d'un objet 

À l'exemple 15-5, l'appel de la fonction mysql_field_name($result,$i ) pourrait être remplacé par 
mysql_fetch_field($result,$i )->name. Cette dernière fonction, ayant pour syntaxe object 
mysql_fetch_field($result,$i ), retourne un objet dont la propriété name contient le nom de la 
colonne dont la position est précisée par l'entier $i . 



Récupération des valeurs dans un objet 

Vous pouvez récupérer non seulement le nom de chaque colonne, comme en appelant 
la fonction mysql_fetch„field( ) , mais également la valeur de chaque colonne d'un résul- 
tat sous la forme d'une propriété d'objet grâce à la fonction mysql_fetch_object( ). 

La syntaxe de cette fonction est la suivante : 

I object mysql_fetch_object( resource Sresult) 

L'objet retourné par cette fonction a autant de propriétés que la requête a sélectionné de 
colonnes, les noms des propriétés étant ceux des colonnes ou des alias éventuels. 
L'exemple 15-6 réalise le même affichage que l'exemple 15-5 en utilisant cette fonction. 
Les seules différences résident dans l'utilisation de la fonction mysql_fetch_field( ) 
(repère Q) pour afficher les en-têtes du tableau XHTML puis de mysql_fetch_object( ) 
pour lire chacune des lignes du résultat (repère 0). 

Un nouvel appel de mysql_fetch_field() permet d'enregistrer le nom de chacune des 
propriétés de l'objet dans la variable $nomcol (repère 0), ce qui permet d'afficher toutes 
les données d'une ligne. La syntaxe $ligne->$nomcol permet de lire chaque propriété de 
l'objet (repère O)- Le résultat affiché est identique à celui de la figure 15-3. 

Exemple 15-6. Lecture des données au moyen d'un objet 

<!DOCTYPE html PUBLIC "-//WSC/ZDTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<htntl xnilns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 
<titl e>Lecture de la table client</title> 
<style type="text/css" > 

table {border-style:double;border-width:3px: border-col or :red; 

^backg round-col or:yel 1 ow; ) 

</style> 

</head> 

<body> 

<?php 

incl ude( "connex. inc.php" ) ; 
$idcom=connex( "magasin" , "myparam" ) ; 

$requete="SELECT id_client AS 'Code client' , nom, prénom, adresse, âge, mail 

FROM client 

WHERE ville ='Paris' 

ORDER BY nom": 
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$result=@niysql_query($ requête. Sidcom) ; 

if( !$result) 

{ 

echo "Lecture impossible": 

} 

else 
{ 

$nbcol=mysql_nuni_fields($ resuit) ; 
$nbart=mysql_nuni_rows($result) ; 

echo "<h3> Il y a $nbart clients habitant Paris</h3>": 
//Affichage des titres du tableau 
echo "<table border=\"l\"> <tr>"; 
for($i=0;$i<$nbcol :$i-H-) 
{ 

echo "<th>", mysql_fetch_field($result,$i )->name," </th>";<— O 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 

for($i=0;$i<$nbart:$i++) 

{ 

$1 igne=mysql_fetch_object($resul t) ; <— © 

echo "<tr>"; 

for($j=0:$j<$nbcol 

{ 

$noincol=mysql_fetch_field($resul t,$j)->name; <— © 
echo "<td>" ,$1 igne->$nonicol , "</td>" ; <— O 

} 

echo "</tr>"; 

) 

echo "</table>"; 
mysql_free_result($result) ; 

} 

?> 

</body> 
</html> 

Insertion de données dans la base 

Un site interactif se doit de permettre aux utilisateurs d'effectuer des saisies de données 
dans un formulaire et de les enregistrer dans une base de données en vue d'une utilisation 
ultérieure. Les méthodes d'insertion à partir de phpMyAdmin ne peuvent évidemment 
pas convenir dans ce cas car elles sont réservées à l'administrateur du site. 

En vous situant toujours dans la perspective de création d'un site de commerce en ligne, 
vous allez envisager comment réaliser la saisie puis l'insertion des coordonnées d'un 
visiteur dans la table cl i ent de la base magasi n. Vous lui permettrez par la suite d'effectuer 
une mise à jour de ses paramètres personnels de façon que la base reste à jour, en cas de 
changement d'adresse, par exemple. 
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Insertion des données 

Comme vous l'avez vu au chapitre 6, consacré aux formulaires, l'outil de communica- 
tion essentiel entre le poste client et le serveur est le formulaire XHTML. Ce dernier 
permet la saisie de données et leur envoi vers le serveur, sur lequel un script PHP enre- 
gistre les valeurs saisies dans la base MySQL. 

Vous disposez déjà de la fonction personnalisée de connexion connexO et de mysql_ 
queryO pour envoyer la requête. Seule la requête qui contient la commande SQL INSERT,qui 
va être envoyée au serveur, distingue cette opération de celle de lecture des données. 

Le script de l'exemple 15-7 réalise ce type d'insertion à partir d'un formulaire permettant 
à un client d'enregistrer ses coordonnées lors d'une commande. Comme ceux du chapi- 
tre 6, il commence par vérifier l'existence des saisies obligatoires correspondant aux 
variables $_POST[ 'nom' ], $_POST[adresse] et $_POST[vi 1 1 e] (repère O)- 

Dans le cas où une requête est formée en utilisant des saisies faites par l'utilisateur dans 
un formulaire, il est préférable d'utiliser un caractère d'échappement pour les caractères 
spéciaux des chaînes récupérées dans le tableau $_POST, en particulier les guillemets, 
qui peuvent poser problème. Vous disposez pour cela des fonctions mysql_escape_string{ ) 
et mysql_real_escape_string( ), dont les syntaxes respectives sont les suivantes : 

Istring mysql_escape_string(string Schaine) 
string niysql_real_escape_string(string $chaine[, resource $idcom]) 

La seconde présente l'avantage de tenir compte du jeu de caractères utilisé. Le jeu de 
caractères utilisé sur le client MySQL peut être lu en appelant la fonction mysql_cl i ent_ 
encodingO, qui retourne ce code dans une chaîne explicite, par exemple 'latinl'. Par 
précaution, il est préférable d'appliquer ces fonctions à chacune des variables récupé- 
rées plutôt qu'à la chaîne de requête dans son entier. Aucune de ces deux fonctions 
n'échappe les caractères "%" et 

Vous récupérez et protégez ensuite toutes les valeurs du tableau $_POST dans des variables 
de façon à obtenir un code plus court par la suite (repères Q à 0). 

La valeur "XN" représente la valeur NULL de la variable $id„client. Elle permet que la 
colonne i dédient de la table client soit incrémentée d'une unité à chaque nouvelle 
insertion car elle est déclarée avec l'option AUTO_INCREMENT. 

La fonction mysql_insert_id( ), dont la syntaxe est la suivante : 

I int mysql_insert_id([$idcom]) 

retourne la dernière valeur insérée dans une colonne ayant cette option AUTO_INCREMENT. Elle 
sert à donner son numéro au client pour qu'il puisse s'identifier lors d'une autre connexion. 

La requête SQL INSERT contenue dans la variable $ requête (repère Q) permet l'insertion 
de toutes ces valeurs dans la table cl ient. Dans le cas d'une commande INSERT, le résultat 
de la requête envoyée par la fonction mysql juery( ) n'est qu'une valeur booléenne TRUE 
ou FALSE selon que l'insertion a été réalisée ou non (repère ©)■ Elle vous permet d'affi- 
cher un message d'information indiquant la bonne exécution de l'insertion. Le numéro 
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attribué au client lui est alors communiqué dans une boîte d'alerte JavaScript (voir 
repère ^ et figure 15-5). 

'•^ Exemple 15-7. Insertion des données avec un formulaire 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtmr' xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=i so-8859-1" /> 

<title>Saisissez vos coordonnées</titl e> 

</head> 

<body> 

<form action^ "<?php echo $_SERVER['PHP_SELF']:?>" method="post" 

enctype="appl ication/x-www-form-url encoded"> 

<fieldset> 

<legend><b>Vos coordonnées</b></legend> 
<table> 

<tr><td>Nom : </td><td><input type="text" name="nom" size="40" maxl ength="30"/> 
^</td></tr> 

<tr><td>Prénom : </td><td><input type="text" name="prenom" size="40" 
^maxlength="30"/></td></tr> 

<tr><td>Age : </td><td><input type="text" name="age" size="40" maxl ength="2"/> 
^</td></tr> 

<tr><td>Adresse : </td><td><input type="text" name="adresse" size="40" 
^maxlength="60"/></td></tr> 

<tr><td>Ville : </td><td><input type="text" name="ville" size="40" maxlength="40"/> 
^</td></tr> 

<tr><td>Mail : </td><td><input type="text" name="mail" size="40" maxl ength="50"/> 

^</td></tr> 

<tr> 

<td><inpLit type="reset" value=" Effacer "></td> 

<td><input type="submit" value=" Envoyer "></td> 

</tr> 

</table> 

</fieldset> 

</form> 

<?php 

include( 'connex.inc.php' ) ; 

if(!empty($_POST['nom'])&& !empty($_POST[' adresse '])&& !empty($_P0ST['ville']))<-O 
{ 

$id_client="\N"; <-© 
$nom= $_POST['nom']: <— 0 
$prenom=$_POST[ 'prénom' ] ; <— O 
$age=$_POST['age']: <— 0 
$adresse=$_POST['adresse']: <— 0 
$vi 1 1 e=$_POST[ ' vi 1 1 e ■ ] : <-© 
$mail=$_POST['mail ']; ^0 
//Requête SQL 

$requete="INSERT INTO client VALUESC ' $id_cl ient ' , ' $nom' , ' Sprenom' , ' $age' . 
^ '$adresse' , '$ville' , '$mail ')"; <— 0 
$idcom=connex( 'magasin' , 'myparam' ) ; 
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$result=mysql_query($requete,$idcom) ; <— ® 
mysql_close($idcom) ; 
if ( !$result) 
{ 

echo "<h2>Erreur d'insertion \n n' " ,inysql_errno( ) , " : " ,inysql_error( ) . "</h2>" ; 



echo "<script type=\"text/javascri pt\"> 
alert('Vous êtes enregistré Votre numéro de client est : " . 
^mysql_insert_id( ) . "' )</script>" ; <— © 

} 
} 

} 

else {echo "Formulaire à compléter!";} 
?> 

</body> 
</html> 

La figure 15-4 illustre la page de saisie. Un affichage du contenu de la table client à 
l'aide de phpMyAdmin vous permettrait de contrôler la bonne insertion des données du 
formulaire. 
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Figure 15-4 

Formulaire d'insertion 
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Figure 15-5 

Communication du numéro de client dans une boîte d 'alerte 



446 



PHP 5 



Mise à jour d'une table 

Pour assurer le meilleur service aux clients du site, il est important de leur permettre de 
modifier leurs coordonnées en cas de changement d'adresse ou de nom. L'exemple 15-8 
crée une page contenant un formulaire de saisie du code client dans une zone de texte. 
Vous pourriez tout aussi bien l'utiliser pour mettre à jour les tarifs de la table arti cl e. 

L'attribut action du formulaire renvoie le traitement des données au fichier mysqlex9.php, 
dont le code est donné à l'exemple 15-9. La page créée est illustrée à la figure 15-6. 

Exemple 15-8. Page de saisie du code client 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Modifiez vos coordonnées</title> 

</head> 

<body> 

<forni action^ "niysqlex9.php" method="post" 
^enctype="appl ication/x-www-form-url encoded"> 
<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnées</b> 
^</legend> 

<table> <tr> <td>Code client : </td> 

<td><input type="text" name="code" size="20" maxl ength="10"/> </td></tr> 

<tr><td>Modifier : </td> <td><input type="submit" value= "Modifier"/></td></tr> 

</table> 

</fieldset> 
</form> 
</body> 
</html> 
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Figure 15-6 

Page de saisie du code client 
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La mise à jour des coordonnées du client est réalisée par le script de l'exemple 15-9. 

La première inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
validé le formulaire sans avoir effectué de saisie (repère O). Rappelons qu'elle doit figu- 
rer en tête du fichier car elle utilise la fonction headerC ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La première crée dynamiquement un 
formulaire permettant la modification des données, et la seconde enregistre ces données 
dans la base. 

Lors du premier appel du fichier de l'exemple 15-9, la condition de l'instruction if 
(repère©) est nécessairement vérifiée car la variable $_POST['modif "] ne contient rien. 
Elle correspond à la valeur associée au bouton submit du formulaire qui n'est pas encore 
créé. Le script crée une connexion au serveur MySQL pour y lire les coordonnées actuel- 
les du client, dont le code est contenu dans la variable $code issue de la page de saisie de 
l'exemple 15-8 (repère 0). 

La requête SQL sélectionne toutes les colonnes de la table cl ient dont l'identifiant client 
(colonne id_client de la table client) correspond à la valeur de la variable $code 
(repère ©) dans le but de compléter le formulaire avec les données actuelles. Cela 
permet de ne saisir que les modifications éventuelles de coordonnées du client, sans 
devoir ressaisir l'ensemble. Ces coordonnées sont lues à l'aide de la fonction mysql_ 
f etch_row( ) puisque le résultat de la requête SELECT ne comporte qu'une seule ligne. Elles 
sont alors contenues dans la variable $coord de type array. Pour afficher les coordonnées 
dans le formulaire, vous devez attribuer les valeurs de ses éléments aux attributs value 
des différents champs <input /> (repère ©). 

La figure 15-7 montre un exemple de création dynamique de formulaire pour le client 
dont l'identifiant vaut 3. Le champ caché code du formulaire permet de passer la valeur 
du code client à la partie du script chargée de l'enregistrement des données modifiées 
(repère Q). 

L'envoi du formulaire utilise la deuxième partie du script, qui met à jour les données du 
visiteur dans la table client après avoir vérifié l'existence de valeurs pour les champs 
obligatoires du formulaire (repère©). Seules les colonnes nom, adresse, ville et mail 
peuvent être mises à jour à l'aide de la requête suivante (repère Q), le reste étant forcé- 
ment inchangé : 

I UPDATE client SET nom= ' $nom' , adresse= ' Sadresse ' , vil 1 e= ' $v11 1 e ' .mai 1 = ' $maH ' 
WHERE id_client='$code' 

La vérification du résultat de la requête (repère ©) permet d'afficher une boîte d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas être une impasse, le visiteur est redirigé d'office vers la page 
d'accueil du site index.htm. (repères ® et ®). 

Exemple 15-9. Page de modification des coordonnées 

|<?php 
i f (empty($_POST[ 'code ' ] ) ) {headerC "Location :mysql exS.php" ) ; ) <— O 



<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtmr' xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-l" /> 

<title>Modifiez vos coordonnées</title> 

</head> 

<body> 

<?php 

if($_POST['modif ']! = ' Enregistrer' ) <— 0 
{ 

//CREATION DU FORMULAIRE 
incl ude( 'connex. inc.php' ) ; 

$code=mysql_escape_string($_POST[ ' code' ] ) ; <— © 
//Requête SQL 

$requete="SELECT * FROM client WHERE id_client='$code' " ; 
$idcom=connex( 'magasin' , 'myparam' ) ; 
$resul t=@mysql_query( $ requête, Sidcom) ; 
$coord=mysql_fetch_row($result) ; <— 0 
mysql_close($idcom) ; 
//Création du formul ai re <— © 

echo "<form action= \"". $_SERVER['PHP_SELF']."\" method=\"post 
^\"enctype=\"appl ication/x-www-form-url encoded\">" ; 
echo "<fieldset>" ; 

echo "<legend><b>Modifiez vos coordonnées</b></l egend>" ; 
echo "<table>": 

echo "<tr><td>Nom : </td><td><input type=\"text\" name=\"nom\" 
^size=\"40\" maxlength=\"3C\" val ue=\"$coord[l]\"/> </td></tr>": 
echo "<tr><td>Prénom : </td><td><input type=\"text\" name=\"prenom 
size=\"40\" maxlength=\"30\" val ue=\"$coord[2]\"/></td></tr>" ; 
echo "<tr><td>Age : </td><td><input type=\"text\" name=\"age\" 
^size=\"40\" maxlength=\"2\" val ue=\"$coord[3]\"/></td></tr>" ; 
echo "<tr><td>Adresse : </td><td><input type=\"text\" name=\"adresse\" 
^size=\"40\" maxlength=\"60\" val ue=\"$coord[4]\"/></td></tr>" : 
echo "<tr><td>Ville : </td><td><input type=\"text\" name=\"ville\" 
^size=\"40\" maxlength=\"40\" val ue=\"$coord[5]\"/></td></tr>" : 
echo "<tr><td>Mail : </td><td><input type=\"text\" name=\"mail\" 
^size=\"40\" maxlength=\"50\" val ue=\"$coord[6]\"/></td></tr>" : 
echo "<tr><td><input type=\"reset\" value=\" Effacer \"></td><td><input 
^type=\"submit\" name=\"modif\" val ue=\"Enregi strer\"></td></tr></tabl e>" 
echo "</f iel dset>" : 

echo "<input type=\"hidden\" name=\"code\" val ue=\"$code\"/>" ; <— 0 
echo "</form>": 

} 

elseif(isset($_POST['nom'])&& isset($_POST[' adresse '])&& 

^isset($_POST['ville'])) ^0 

{ 

//ENREGISTREMENT 
includeC 'connex. inc. php' ) ; 
$nom=mysql_escape_st ri ng ( $_POST[ ' nom ' ] ) ; 
$adresse=mysql_escape_string($_POST[ 'adresse' ] ) ; 
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$vil le=mysql_escape_string($_POST[ 'ville']); 
$mail=mysql_escape_string($_POST[ 'mai 1 ' ] ) ; 
$code=mysql_escape_string($_POST[ 'code' ] ) ; 
//Requête SQL 

$requete=''LIPDATE client SET nom='$nom' ,adresse='$adresse' ,ville='$ville' , s 

^mail = '$mair WHERE id_cl ient=' Scode'" ; <— 0 

$idconi=connex( 'magasin' , 'myparam' ) ; 

$resul t=mysql_query($ requête, $idcom) ; 

mysql_close($idcom) ; 

if(!$result) <-© 

{ 

echo "<script type=\"text/javascri pt\"> 

al ert( ' Erreur : " .mysql_error( ) . " ' )</script>'' ; <— © 

) 

el se 
{ 

echo "<script type=\"text/javascri pt\"> alert('Vos modifications 
^sont enregistrées' ) ;window.location='index.htm' ;</script>" ; <— ® 

} 

} 

el se 
{ 

echo "Modifier vos coordonnées!"; 

} 

?> 

</body> 
</html> 
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Figure 15-7 

Page de saisie des coordonnées créée dynamiquement 
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Vérification 

Pour vérifier que la mise à jour a bien été réalisée, vous pourriez appeler la fonction mysql_af f ected_ 
rows( ), dont la syntaxe est int mysql_affected_rows( [$idcom] ). Elle retourne le nombre de lignes 
concernées par les commandes SQL INSERT, UPDATE et DELETE. Lors de la mise à jour des coordon- 
nées d'un client, elle retourne la valeur 1 si l'opération est menée à bien. Au repère © de l'exemple 15-9, 
vous pourriez donc écrire : 

if (iiiysql_affected_rows( ) !=1) 
{//Affichage de l'erreur 

} 

el se 

{//Message de confirmation 
} 



Recherche dans la base 

Un site de commerce en ligne doit permettre à ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de données afin d'accéder plus rapidement à l'information 
sur le produit recherché. Il doit en outre permettre d'effectuer des statistiques marketing 
à l'usage du propriétaire du site. Ces recherches concernent aussi bien les sites de 
commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 15-10 crée un formulaire classique permettant de saisir un mot-clé et d'effec- 
tuer des choix de tri des résultats. Les critères de tri selon le prix, la catégorie ou l'identi- 
fiant d'article sont affichés sous forme de liste déroulante ainsi que celui du critère de tri 
selon le prix, la catégorie ou l'identifiant d'article. Le choix de l'ordre croissant ou 
décroissant s'effectue au moyen de deux boutons radio ayant le même attribut name, ce 
qui les rend exclusifs l'un de l'autre. 

Le script contrôle d'abord que le visiteur a saisi un mot-clé dans le formulaire en véri- 
fiant que la variable $„POST['motcle'] n'est pas vide (repère Q)- H récupère ensuite le 
mot-clé, la catégorie, le critère de tri et l'ordre d'affichage respectivement dans les varia- 
bles Smotcle, $categorie, $ordre et $tri (repères 0 à 0). 

Si la catégorie choisie est "tous", la partie de la commande WHERE concernant cette catégo- 
rie est vide. Pour les autres choix, elle est égale à "AND categorie=$categorie" (repère ©). 
La requête de sélection suivante (repère 0) est alors créée par le code : 

"SELECT id_article AS 'Code article' .désignation AS 'Description' , prix, catégorie AS 

'Catégorie' 

FROM article 

WHERE lower(designation) LIKE'^Smotcl e%' " . Sreqcategorie. " 
ORDER BY $tri $ordre" 

On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche sans tenir compte de la casse ; de cette façon, que l'utilisateur cherche les 
mots-clés sony ou Sony il obtiendra bien les résultats présents dans la table arti cl e. 



Accès procédural à MySQL avec PHP 

Chapitre 15 



L'utilisation d'alias donne un meilleur affichage des titres du tableau de résultats. Après 
la connexion au serveur, vous récupérez le résultat de la requête dans la variable Sresult. 
La lecture des résultats et l'affichage de toutes les lignes retournées sont réalisés par le 
même code que celui de l'exemple 15-5 (repère 0). La figure 15-8 illustre la page créée 
après la recherche du mot-clé portabi e. 

f*' Exemple 15-10. Page de recherche d'articles 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtcl"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<nieta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<forni action= "<?php echo $_SERVER['PHP_SELF']?>" method="post" 

*enctype="appl i cation/x-www-form-url encoded"> 

<fieldset> 

<1 egend><b>Rechercher un article en niagasin</b></legend> 
<table> 

<tr> <td>Mot-clé: </td> 

<td><input type="text" name="motcl e" size="40" maxlength="40" 

^value="<?php $_POST[ 'motel e']?>"/></td> 

</tr> 

<tr> 

<td>Dans la catégorie : </td> 
<td> 

<select name="categDrie"> 

<option val ue=" tous" >Tous</optiDn> 

<option val ue="vidéD">Vidéo</option> 

<option val ue=" informatique" >Informatique</option> 

<option val ue=" photo ">Photo</option> 

<option val ue= "divers ">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 
<td> 

<select name="tri"> 

<option val ue=" prix" >Prix</option> 

<option val ue=" catégorie" >Catégorie</option> 

<option val ue="id_article">Code</option> 

</select> 

</td> 

</tr> 

<tr><td>En ordre: </td> 



<td>Croissant<input type="radio" name="ordre" value="ASC" checked="checked"/> 
^Décroissant<input type="radio" name="ordre" value="DESC" /> 
</td> </tr> 

<tr><td>Envoyer</td><td><input type="submit" name="" value="OK"/> </td> </tr> 
</table> 
</fieldset> 
</form> 
<?php 

if(!empty($_POST['motcle'])) 
{ 

include( 'connex.inc.php' ) ; 

$motcl e=mysql_escape_string($_POST[ ' motel e' ] ) ; <— 0 
$categorie=mysql_escape_st ri ng($_POST[' catégorie' ] ) ; <— © 
$ordre=mysql_escape_string($_POST[ 'ordre' ] ) ; <— O 
$tri=mysql_escape_string($_POST[ 'tri ']); <— © 

//Requête SQL 

$reqcategorie=($_POST[ 'categorie']=="tous" )?"" : "AND catégorie^ 
^ ' Scategorie'" ; <— © 

$requete="SELECT id_article AS 'Code article' .désignation AS 'Description' .prix, 

^catégorie AS 'Catégorie' FROM article WHERE lower(designation) LIKE'^ 

^$ntotcle^"'.$reqcategorie.''ORDER BY $tri $ordre":<— © 

$idcom=connex( 'magasin' . 'myparam' ) ; 

$resul t=my sql_query($ requête. $idcom) ; <— © 

if(!$result) <-© 

{ 

echo "Lecture impossible"; 

) 

else 
{ 

$nbcol=mysql_num_fields($ resuit) ; 
$nbart=mysql_num_rows($result) ; 

echo "<h3> Il y a $nbart articles correspondant au mot-clé : $motcle</h3>"; 
//Affichage des titres du tableau 
echo "<table border=\''l\"> <tr>": 
for($i=0:$i<$nbcol :$i++) 

{ 

echo "<th>", mysql_f ield_name($resul t .$i ) . " </th>"; 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
for($i=0:$i<$nbart:$i++) 

{ 

$1 igne=mysql_fetch_row($resul t) ; 
echo "<tr>"; 

for($j=0;$j<$nbcol :$j++) 
{ 

echo "<td>" .$1 igne[$j] . "</td>" ; 

) 
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echo "</tr>"; 

} 

echo "</table>"; 
mysql_free_result($result) ; 



} 

?> 

</body> 
</htnil> 
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Figure 15-8 

Formulaire de recherche et résultats obtenus 



Ce chapitre a montré les différentes techniques qui permettent de lire les données d'une 
base et d'en enrichir le contenu à partir de saisies effectuées dans un formulaire. 

La sélection d'informations en réponse à la requête d'un visiteur et l'affichage des résul- 
tats dans une page créée dynamiquement à partir de ces résultats sont les éléments 
prépondérants de la création de sites dynamiques. Les études de cas du chapitre 21 illus- 
trent davantage ces techniques. 
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Mémo des fonctions 

int mysql_affected_rows( [resource $idcom]) 

Retourne le nombre de lignes concernées par la dernière requête SQL INSERT, DELETE ou UPDATE envoyée au serveur, 
string mysql_cl ient_encoding( [resource $idcoin]) 

Retourne ie nom du jeu de caractères utiiisé par le ciient MySQL pour la connexion en cours si elle n'est pas précisée, 
boolean niysql_cl ose( [resource $idcom]) 

Ferme la connexion MySQL dont l'identifiant est précisé ou la connexion en cours. Retourne TRUE si l'opération a lieu et 
FALSE dans le cas contraire. 

resource mysql_connect(string $liost, string $user, string $pass) 

Ouvre une connexion à un serveur MySQL identifié par $host pour le client $user et le mot de passe $pass. Retourne 
un identifiant de connexion. 

boolean niysql_data_seek( resource $result,int numéro_l igne) 

Place le pointeur dans le résultat $result à la ligne indiquée et retourne TRUE si l'opération est réussie. L'appel de la 
fonction iiiysql_fetcli_row( ) retourne cette ligne. 

string niy5ql_db_name( resource $result,int N) 

Retourne le nom de la nième base figurant dans le résultat $resul t retourné par la fonction inysql_l i st_dbs( ). 
int inysql_errno( [resource $idcom]) 

Retourne le numéro de la dernière erreur survenue pour la connexion précisée ou celle qui est en cours si le paramètre 
est omis. 

string mysql_error( [resource $idcom]) 

Retourne le dernier message d'erreur pour la connexion précisée ou celle qui est en cours si le paramètre est omis, 
string mysql_escape_string(string $cfi) 

Protège les caractères spéciaux de la cliaîne $cli (sauf % et _) et retourne la cfiaîne protégée, 
array mysql_fetcfi_array( resource $result[,int typetab]) 

Retourne la ligne en cours du résultat dans un tableau. Cfiaque appel de la fonction retourne la ligne suivante ou FALSE 
s'il n'y a plus de ligne. Le paramètre typetab précise le type du tableau retourné : associatif avec la valeur MYSQL_ASSOC, 
indicé avec la valeur MYSQL_NUM, les deux avec MYSQL_BOTH (utilise plus de mémoire). 

array mysql_fetch_assoc( resource $result) 

Identique à la fonction mysql_fetch_array( ) utilisée avec le paramètre MYSQL_ASSOC. 
object mysql_fetch_fi el d( resource $result [,int numero_col onne] ) 

Retourne un objet dont les propriétés contiennent des informations sur les données du résultat. Ces propriétés sont les 
suivantes : 

name : nom de la colonne, 
table: nom de la table contenant la colonne. 
max_l ength : taille de la colonne de type VARCHAR. 
not_nul 1 : vaut 1 si la colonne a cette option. 
primary_key : vaut 1 si la colonne est une clé primaire. 
unique_key : vaut 1 si la colonne a l'option UNIQUE. 
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nul ti pl e_key : vaut 1 si la colonne est une clé non unique, 
numeric : vaut 1 si la colonne est de type numérique, 
bl ob : vaut 1 si la colonne est de type BLOB. 
type : type de la colonne. 

unsigned : vaut 1 si la colonne a l'option UNSIGNED. 

zerofill : vaut 1 si la colonne a l'option ZEROFILL (pour les types numériques), 
array mysql_fetch_l engttis( resource $result) 
Retourne la taille de ctiaque colonne du résultat, 
object mysql_fetch_object( resource $result) 

Retourne une ligne du résultat dans un objet dont les propriétés ont pour nom celui des colonnes et qui contiennent les 
valeurs de chaque colonne. 

array inysql_fetcti_row( resource $result) 

Retourne un tableau indicé contenant la ligne en cours du résultat précisé et FALSE s'il n'y a plus de ligne, 
string inysql_field_flags(resource $result, int numero_col onne) 

Retourne les options de la colonne précisée du résultat. Les valeurs possibles sont : ' not_nul 1 ' , ' prima ry_key' , 
' um'que_key ' , 'multiple_key' , 'blob', 'unsigned', 'zerofill', 'binary', 'enum', 'auto_increment' 
et ' timestamp' . Voir aussi la fonction mysql_fetch_f iel d( ). 

int mysql_field_len(resource $result, int N) 

Retourne la taille de la colonne N du résultat. 

string mysql_field_name(resource Sresult, int N) 

Retourne le nom de la nième colonne du résultat. 

int mysql_field_seek(resource $result, int numéro_col onne) 

Place le pointeur de résultat sur la nième colonne du résultat. L'appel de la fonction mysql_fetcti_f i el d( ) retourne la 
valeur du champ. 

string mysql_field_table( resource $result,int N) 
Retourne le nom de la table qui contient la nième colonne du résultat, 
string mysql_f iel d_type( (resource $result, int N) 
Retourne le type de la nième colonne du résultat, 
boolean mysql_free_result(resource $result) 

Libère la mémoire utilisée par le résultat et retourne TRUE en cas de réussite et FALSE dans le cas contraire, 
int mysql_insert_id(rescurce $idcom) 

Retourne la dernière valeur entière Insérée dans une colonne ayant l'option AUTO_INCREMENT. 
rescurce mysql_l ist_dbs( rescurce $idcom) 

Retourne un identifiant de résultat contenant la liste des bases de données du serveur MySQL. 
rescurce mysql_l ist_fields(string base, string table[, resource $idcom]) 

Retourne un identifiant de résultat contenant la liste des colonnes d'une table donnée située dans une base précisée, 
rsource mysql_l ist_tabl es(string base[, resource $idcom]) 
Retourne un identifiant de résultat contenant la liste des tables d'une base. 
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int mysql_niim_fields( resource Sresult) 
Retourne le nombre de colonnes présentes dans un résultat, 
int inysql_njin_rows(resojrce $result) 
Retourne le nombre de lignes d'un résultat. 

resource iiiysql_pconnect(string $host,string $user,string $pass) 
Identique à la fonction niysql_connect( ) mais crée une connexion permanente, 
boolean niysql_ping([resource $idcom]) 

Vérifies! la connexion est toujours active et effectue une reconnexion dans le cas contraire. Retourne TRUE si la connexion 
est effectuée et FALSE dans le cas contraire. 

resource mysql_query(string $requete[ , resource $idcom[ , int mode]]) 

Envoie une requête SQL au serveur et retourne un identifiant de résultat. 

string mysql_real_escape_string(string $chaine [, resource $idcoin]) 

Écfiappe la cfiaîne précisée afin de l'inclure dans une requête SQL. 

divers mysql_resul t( resource $result,int N [.divers M]) 

Retourne la valeur du cfiamp de la colonne M de la ligne N du résultat. 

boolean mysql_select_db(string base[ . resource $idcom]) 

Choisit la base sur laquelle vont s'effectuer les opérations suivantes. Retourne TRUE si la base existe et FALSE dans le cas 
contraire. 

string mysql_tabl ename( resource $result,int N) 

Utilise l'Identifiant de résultat retourné par la fonction mysql_l ist_tabl es( ) et retourne le nom de la nième table de la 
base. 

resource mysql_unbuffered_query(string $requete[ , resource $idcom]) 

Envoie une requête au serveur mais ne met pas le résultat en buffer. Le résultat doit être utilisé avant l'envoi d'une autre 
requête. 

Exercices 

Tous les exercices ci-dessous portent sur la base de données voitures créée au chapi- 
tres 13 et 14. 

Exercice 1 

Créez un script permettant d'afficher le contenu de la table modèle dans un tableau 
XHTML. Les résultats doivent être triés par marque. 

Exercice 2 

Créez un formulaire permettant l'insertion de nouvelles données dans la table model e. 
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Exercice 3 

Créez un formulaire permettant l'insertion simultanée des coordonnées d'une personne 
dans les tables propriétaire et cartegrise. Il doit contenir les zones de saisie des coor- 
données de la personne et la liste des modèles d'une marque créée dynamiquement à 
partir de la saisie de la marque. 

Exercice 4 

Créez un formulaire de recherche permettant de retrouver tous les propriétaires d'un type 
de véhicule de marque et de modèle donnés. Affichez les résultats sous forme de tableau 
XHTML. 

Exercice 5 

Créez un formulaire de recherche permettant de retrouver tous les véhicules possédés par 
une personne donnée. Affichez les résultats sous forme de tableau XHTML. 

Exercice 6 

Réécrivez entièrement le code de l'exercice 5 en récupérant tous les résultats dans des 
objets et en manipulant leurs propriétés. 
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Accès objet à MySQL 

avec PHP 



Une tendance évidente qui a prévalu dans le développement de PHP 5 est la programma- 
tion objet ; l'accès à MySQL n'y a pas échappé, et cela n'a fait que s'accentuer dans les 
versions successives de PHP 5. Cette possibilité est liée à l'utilisation de l'extension 
tnysqli, dite « mysql améliorée », qui comprend les trois classes suivantes : 

• La classe mysql i qui permet de créer des objets de type mysql i_object. Cette dernière 
possède pas moins de 33 méthodes et 15 propriétés pouvant remplacer ou compléter 
les fonctions de l'extension mysql comme la connexion à la base, l'envoi de requêtes, 
les transactions ou les requêtes préparées. 

• La classe mysql i_resul t, permettant de gérer les résultats d'une requête SQL effectuée 
par l'objet précédent. Ses méthodes et propriétés sont également les équivalents des 
fonctions de l'extension mysql vues au chapitre 15. 

• La classe mysql_stmt qui représente une requête préparée. Il s'agit là d'une nouveauté 
par rapport à l'extension mysql . 

Nous allons maintenant reprendre des différents exemples du chapitre 15 et voir comment 
obtenir les mêmes résultats via un accès objet. Ce chapitre peut donc être abordé indé- 
pendamment du chapitre précédent. 

Connexion au serveur MySQL 

Comme il se doit, la première chose à faire est de se connecter au serveur MySQL. Pour 
cela nous créons un objet de la classe mysql i selon la syntaxe suivante : 
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I $idcom = new mysqli (string $host. string Suser, string $pass [.string $base]) ; 

Sidcom est un objet mysql i et $host, $user et $pass sont, comme dans le chapitre 15, le nom 
du serveur MySQL, le nom de l'utilisateur et le mot de passe. Le paramètre facultatif 
$base permet de choisir d'emblée la base sur laquelle seront effectuées les commandes 
SQL. 

Nous pouvons également réutiliser le fichier myparam.inc.php, créé au chapitre 15, 
contentant les paramètres de connexions (ci-dessous en local) : 

'•^ Exemple 1 6-1 . Le fichier myparam.inc.php 

<?php 

def i ne( "MYHOST" , "1 ocal host" ) ; 

define("MYUSER","root"): 

defineC'MYPASS".""): 

?> 

L'objet Sidcom représentant la connexion sera utilisé directement ou indirectement pour 
toutes les opérations à effectuer sur la base. Si la connexion n'est pas effectuée, la varia- 
ble Sidcom contiendra la valeur FALSE, permettant ainsi de tester si la connexion est bien 
réalisée. 

La connexion prend fin quand l'exécution du script PHP est terminée, mais on peut y 
mettre fin explicitement pour observer le serveur MySQL. Si les résultats d'une requête 
sont entièrement récupérés, la connexion peut en effet être coupée avec la méthode 
cl ose( ) selon la syntaxe suivante : 

I boolean $idcom->close() 

Si le serveur comporte plusieurs bases de données et que le paramètre $base a été 
employé lors de la création de l'objet $i dcom, il est possible de changer de base sans inter- 
rompre la connexion en cours en appelant la méthode select_db() avec la syntaxe 
suivante : 

[ boolean $idcom->select_db (string Sbase) 

Cette méthode retourne un booléen qui permet de tester la bonne fin de l'opération. Si le 
paramètre $base n'a pas été précisé lors de la création de l'objet mysqli, c'est cette 
méthode qui permet de choisir la base. 



Sélection de la base via SQL 

Comme nous l'avons vu au chapitre 15, vous pouvez aussi sélectionner une base en envoyant la requête 
"USE nom_base" au serveur à l'aide de la méthode query ( ) détaillée dans les sections suivantes. 



En cours de script, vous pouvez à tout moment tester si la connexion est encore active en 
appelant la méthode ping( ) selon la syntaxe suivante : 

I boolean $idcom->ping( ) 
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Celle-ci renvoie TRUE si la connexion est active, sinon elle renvoie FALSE et effectue une 
reconnexion avec les paramètres initiaux. 

La structure d'un script accédant à MySQL est donc la suivante : 
<?php 

//Inclusion des paramètres de connexion 
incl ude_once("myparam.inc.php") ; 

//Connexion au serveur 

Sidcom = new mysqli (MYHOST.MYUSER.MYPASS."ma_base") : 

//Affichage d'un message en cas d'erreurs 

if( !$idcom) 

{ 

echo "<script type=text/javascript>" ; 

echo "alert( 'Connexion Impossible à la base)</script>" ; 

} 

//Requêtes SQL sur la base choisie 
//Lecture des résultats 

//Fermeture de la connexion 

$idcom->cl ose( ) ; 

?> 

Comme nous l'avons fait pour l'accès procédural à MySQL, nous avons intérêt à créer 
une fonction de connexion au serveur que nous réutiliserons systématiquement dans 
tous les exemples qui suivent. C'est l'objet de l'exemple 16-2 qui crée la fonction 
connexobjet( ) dont les paramètres sont le nom de la base dans la variable $base et le nom 
du fichier . i ne . php contenant les paramètres de connexion dans la variable $param. 

La fonction inclut d'abord les paramètres de connexion (repère O) puis crée un objet 
mysql i (repère ©) ; elle vérifie ensuite que la connexion est bien réalisée (repère 0), affi- 
che un message d'alerte JavaScript et sort de la fonction en cas de problème (repère ©). Si 
la connexion est bien réalisée elle retourne l'objet $idcom (repère 0). 

Exemple 16-2. Fonction de connexion au serveur 

<?php 

function connexobjet($base,$param) 
{ 

incl ude_once($param. " .inc. php" ) ; <— O 

$idcom = new mysql i (MYHOST,MYUSER,MYPASS.$base) ; <-© 

if (!$idcom) <-© 

{ 

echo "<script type=text/javascript>" ; 

echo ''alert( 'Connexion Impossible à la base' )</script>" ; 

exitO; <-0 

) 

return Sidcom; <— 0 

} 

?> 
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Chacun de vos scripts d'accès à la base doit donc contenir les lignes suivantes : 

IincludeC'connexobjet.inc.php"); 
$idcom = connexobjet ( "noni_base" , "myparam "); 

L'opération de connexion est donc gérée en deux Lignes. 

Envoi de requêtes SQL au serveur 

Les différentes opérations à réaliser sur la base MySQL impliquent l'envoi de requêtes 
SQL au serveur. 

Pour envoyer une requête, il faut employer la méthode query( ) de l'objet mysql i dont la 
syntaxe est : 

I divers $idcom->query (string $requete [,int mode ]) 

La requête est soit directement une chaîne de caractères, soit une variable de même type. 
Le paramètre mode est une constante qui prend la valeur MYSQLI_USE_RESULT ou MYSQLI_ 
STORE„RESULT, cette dernière étant la valeur par défaut. Avec MYSQLI_STORE_RESULT, il est 
possible d'envoyer plusieurs requêtes sans libérer la mémoire associée à un premier 
résultat, tandis qu'avec l'autre méthode, il faut d'abord libérer cette mémoire à l'aide de 
la méthode free_result( ) appliquée à l'objet $result (de type mysql i_result). 

La méthode query( ) retourne TRUE en cas de réussite et FALSE sinon et un objet de type 
mysql i_resul t pour les commandes SQL de sélection comme SELECT. Nous pouvons donc 
tester la bonne exécution d'une requête. En résumé, un script d'envoi de requête a la 
forme suivante : 

Exemple 1 6-3 Envoi de requête type 

<?php 

incl ude_once( "connexobjet . inc. php" ) ; <— O 

$i dcom=connexobj et ( "magasin" , "myparam" ) ; <— © 

$reqLiete="SELECT * FROM article ORDER BY catégorie" ; <—© 

$resLilt=$idcom->query($requete) ; <— O 

if( !$result) 

{ 

echo "Lecture impossible" : <—© 

} 

el se 
{ 

//Lecture des résultats <—© 

while ($row = $resul t->fetch_array(MYSQLI_NUM) ) 

{ 

foreach($row as $donn) 
{ 

echo $donn , "  " ; 

) 

echo "<hr />"; 
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] 

//Destruction de l'objet Sresult 
$resul t->close( ) ; 

} 

// Fermeture de la connexion 

$idcoin->cl ose( ) ; <— © 

?> 

Ce script effectue successivement l'inclusion du fichier connexobjet.inc.php (repère 0)> 1^ 
connexion au serveur (repère ©), l'écriture de la requête SQL dans la variable Srequete 
(repère 0), l'envoi de la requête et la récupération du résultat (repère Q) puis l'affichage 
d'un message d'erreur éventuel (repère 0) ou bien des résultats, procédure que nous 
détaillerons dans le paragraphe suivant (repère 0) et, enfin, la libération de la mémoire 
occupée par l'objet mysql i„resul t (repère Q). 



Lecture du résultat d'une requête 

Pour les opérations d'insertion, de suppression ou de mise à jour de données dans une 
base, il est simplement utile de vérifier si la requête a bien été exécutée. 

Par contre, lorsqu'il s'agit de lire le résultat d'une requête contenant la commande SELECT, la 
méthode query ( ) retourne un objet de type mysql i_resul t, identifié dans nos exemples par 
la variable $resul t. La classe mysql i_resul t offre une grande variété de méthodes permet- 
tant de récupérer des données sous des formes diverses, la plus courante étant un tableau. 
Chacune de ces méthodes ne récupérant qu'une ligne du tableau à la fois, il faut recourir 
à une ou plusieurs boucles pour lire l'ensemble des données. 



Lecture à l'aide d'un tableau 

La méthode des objets instances de la classe mysql i„resul t la plus perfectionnée pour lire 
des données dans un tableau est fetch_array( ), dont la syntaxe est : 

I array $resul t->fetch_array (int type) 

Elle retourne un tableau qui peut être indicé (si la constante type vaut MYSQLIJUM), asso- 
ciatif (si type vaut MYSQLI_ASSOC), dont les clés sont les noms des colonnes ou les alias de 
la table interrogée, ou encore mixte, contenant à la fois les indices et les clés (si type vaut 
MYSQLI_BOTH). Pour lire toutes les lignes du résultat, il faut écrire une boucle (while par 
exemple) qui effectue un nouvel appel de la méthode fetch_array( ) pour chaque ligne. 
Cette boucle teste s'il existe encore des lignes à lire, la méthode fetch_array( ) retournant 
la valeur NULL quand il n'y en a plus. Pour lire et afficher chaque ligne nous utilisons 
ensuite une boucle foreach. Notez encore une fois que si le tableau retourné est indicé, 
l'indice 0 correspond au premier attribut écrit dans la requête et ainsi de suite. 

Les méthodes suivantes permettent également de récupérer une ligne de résultat à la fois : 

I array $result->fetch_assoc(void) 
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retourne un tableau associatif dont les clés sont les noms des colonnes de la table. 
I array $result->fetch_row(voicl) 

donc les indices de 0 à N sont les positions des attributs dans la requête SQL. 

L'exemple 16-4 met cette méthode en pratique dans le but d'afficher le contenu de 
la table arti cl e de la base magasi n dans un tableau XHTML. Après l'inclusion de la fonc- 
tion de connexion (repère O) puis son appel sur la base magasi n (repère 0) nous écrivons 
la requête SQL de sélection (repère 0). L'envoi de la requête avec la méthode query( ) 
permet de récupérer un objet $resuU ou FALSE en cas d'échec (repère ©). Un test sur 
la variable $result (repère 0) permet d'afficher un message d'erreur (repère ©) ou le 
contenu de la table (repère Q). Nous récupérons d'abord le nombre d'articles dans la 
table grâce à la propriété num_rows de l'objet mysqli„result (repère©) et affichons ce 
nombre dans un titre <h4> (repère Q). Une boucle whi 1 e permet de lire une ligne à la fois 
dans un tableau indicé (repère ©), puis une boucle foreach permet d'afficher chacune 
des valeurs du tableau dans un tableau XHTML (repère®). L'objet $result est alors 
supprimé (repère ®) et la connexion fermée (repère ©). La figure 16-1 montre l'affi- 
chage obtenu dans un navigateur. 

Exemple 16-4. Lecture de la table article 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=utf-8" /> 
<titl e>Lecture de la table article</title> 
<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color:red: 

^background-color: yellow;) 

</style> 
</head> 
<body> 
<?php 

include("connexobjet.inc.php" ) ; <— O 

$i dcom=connexobj et ( "magasin" , "myparam" ) ; <— © 

$requete="SELECT * FROM article ORDER BY catégorie":^© 

$result=$idcom->query($requete) ; <— O 

if( !$result) <-© 

{ 

echo "Lecture impossible" ; <—© 

} 

else <— © 
{ 

$nbcol =$resul t->f iel d_count ; 
$nbart=$result->num_rows; <— © 

echo "<h3> Tous nos articles par catégorie</h3>" ; 
echo "<h4> Il y a $nbart articles en magasin </h4>";<— © 
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echo "<table border=\"l\">" ; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 
^<th>Cat&#233:gorie</th></tr>" ; 
while($ligne=$result->fetch_array(MYSQLI_NUM)) <-® 
{ 

echo "<tr>"; 

foreach($ligne as $valeur) <— 
{ 

echo "<td> $valeur </td>"; 

} 

echo "</tr>"; 

} 

echo "</table>": 

} 

$result->close( ) ; <— © 
$idcom->close(); <— © 
?> 

</body> 
</html> 
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Lecture des noms de colonnes. 

Dans l'exemple précédent, les titres des colonnes du tableau XHTML étant écrits à 
l'avance dans le script, nous pouvons automatiser cette opération en récupérant les noms 
des colonnes de la table interrogée ou les alias figurant dans les requête SQL. La 
méthode fetch_fielcls() d'un objet mysql i_result nous fournit ces informations et bien 
d'autres concernant la table. Sa syntaxe est : 

I array $result->fetch_fields(void) 

Le tableau retourné contient autant d'objets qu'il existe de colonnes dans la requête SQL. 
Ces derniers ont tous les mêmes propriétés, détaillées dans le tableau 16-1, permettant 
d'obtenir des informations sur les attributs de la table. 



Tableau 16-1 Définition des propriétés 



Propriété 


Définition 


name 


Nom de la colonne 


orgname 


Nom Initial de la colonne si un allas a été créé 


table 

1 


Nom de la table à laquelle la colonne appartient (s'il n'a pas été obtenu dynamiquement par conca- 
ténation par exemple) 


orgtabl e 


Nom Initial de ia table si un allas a été créé 


def 


Valeur par défaut de l'attribut, donnée dans une chaîne de caractères 


max_l ength 


Longueur maximale du champ pour le jeu de résultats 


1 ength 


Longueur du champ dans la définition de table 


charsetnr 


Jeu de caractères pour cet attribut 


flags 


Entier représentant le bit-flags pour cet attribut 


type 


Type de données utilisées pour l'attribut 


décimal s 


Nombre de décimales utilisées (pour les attributs de type entier) 



Ces informations peuvent nous permettre de reconstituer la structure de la table à laquelle 
nous avons accès sans en connaître les détails. 

Nous allons utiliser une de ces propriétés pour créer automatiquement les en-têtes d'un 
tableau XHTML à partir des noms des colonnes ou des alias éventuels définis dans la 
requête. L'exemple 16-5 illustre cette possibilité à partir d'une requête SQL sélection- 
nant les articles de la table arti cl e dont la désignation contient le mot « Sony » en défi- 
nissant des alias pour les noms des colonnes (repère O). Après l'envoi de la requête par 
la méthode queryO, nous récupérons le résultat (repère 0) puis son nombre de lignes 
(repère 0) et le tableau d'objets Stitres contenant les informations présentées dans le 
tableau 16-1 (repère Q). Les noms des colonnes ou des alias employés ici sont contenus 
dans les propriétés $titres->name et lus un par un à l'aide d'une boucle foreach 
(repère 0), puis affichés dans les en-têtes par des éléments <th> du tableau XHTML 
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(repère ©). L'affichage des données sélectionnées est réalisé dans une boucle whi 1 e avec 
la méthode f etch_array( ) comme dans l'exemple précédent. Le tableau retourné étant ici 
indicé (repère Q), sa lecture est effectuée par une boucle foreach. Le résultat et l'objet 
connexion sont ensuite supprimés. 

'•^ Exemple 16-5. Lecture des noms des colonnes 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtnilll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<ineta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table arti cl e</titl e> 
<style type="text/css" > 

table {border-style:double;border-width: 3px;border-color:red; 

^background-color: yellow;) 

</style> 
</head> 
<body> 
<?php 

incl ude( "connexobjet . inc.php" ) ; 
$idcom=connexobjet( "magasin" , "myparam" ) ; 

// 

$requete="SELECT id_article AS 'Code article' .désignation AS 'Désignation' , prix 
^AS 'Prix Unitaire' .catégorie AS 'Catégorie' FROM article WHERE désignation 
^LIKE '^Sony^' ORDER BY categori e" ; <-© 

// 

$result=$idcom->query($requete) ; <— 0 

// 

if( !$result) 
{ 

echo "Lecture impossible": 

) 

el se 
{ 

$nbart=$resul t->num_rows ; <— © 

$titres=$result->fetch_fields( ) ; <— O 

echo "<h3> Tous nos articles de la marque Sony</h3>"; 

echo "<h4> Il y a $nbart articles en magasin </h4>"; 

echo "<table border=\"l\"> <tr>"; 

//Affichage des titres 

foreach($titres as Scolonne) <— © 

{ 

echo "<th>". htmlentities($colonne->name) ."</th>":<— © 

) 

echo "</tr>"; 

//Lecture des lignes de résultat 
while($ligne=$result->fetch_array(MYSQLI_NUM)) <-© 
{ 

echo "<tr>"; 

foreach($ligne as Svaleur) 
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echo "<td> $valeur </tcl>": 

} 

echo "</tr>"; 

) 

echo "</table>"; 

} 

$resul t->f ree_resul t( ) ; 
$iclcoin->close( ) ; 
?> 

</body> 
</html> 

La figure 16-2 illustre les résultats obtenus. 
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Récupération des valeurs dans un objet 

Les objets de type mysqli_result possèdent la méthode fetch_object( ) dont la syntaxe 
est : 

I object $result->fetch_object( ) 

A chaque appel de cette méthode, l'objet retourné représente une ligne de résultat et 
possède autant de propriétés qu'il existe d'attributs dans la requête SQL SELECT ; les noms 
de ces propriétés sont ceux des colonnes de la table ou des alias éventuels. 

Si nous récupérons une ligne de résultat dans la variable $1 igne : 

I $ligne=$result->fetch_object( ) 

La valeur d'un attribut nom est lue avec la ligne de code : 
I $ligne->nom 
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L'exemple 16-6 réalise, en employant cette méthode, la recherche et l'affichage dans un 
tableau XHTML de tous les clients qui habitent Paris. Par contre, pour afficher les titres 
du tableau nous n'allons pas utiliser la méthode fetch_fields( ) comme précédemment. 
Dans la requête SQL nous définissons des alias qui vont être les en-têtes (repère O). 
Pour les lire, nous appelons une première fois la méthode fetch_object( ) pour l'objet 
$result (repère 0) et récupérons un objet $titres. Ici, ce ne sont pas les valeurs de ses 
propriétés qui nous intéressent mais leurs noms. Ces derniers sont récupérables dans la 
variable $colonne en appliquant une boucle foreach à l'objet $titres (repère©). Nous 
intégrons alors ces valeurs dans des éléments <th> (repère Q). Nous pourrions mainte- 
nant appeler de nouveau la méthode fetch_object( ) pour lire les données mais, àce niveau, 
il se pose un problème. En effet, cette méthode ayant déjà été appelée, un deuxième appel 
lirait la deuxième ligne de résultat et la première serait perdue. Une solution est d'utiliser 
la méthode data_seek( ) (repère 0), dont la syntaxe est : 

boolean $result->data_seek(int N) 

Le paramètre N désigne la ligne de résultat sur laquelle nous voulons pointer. Le booléen 
retourné permet de vérifier que l'opération est bien réalisée et que la ligne N existe bien, 
par exemple. Nous pouvons maintenant utiliser une boucle while pour lire chacune des 
lignes du résultat (repère 0) et afficher les données. Remarquez que, comme nous 
l'avons déjà signalé, les noms des propriétés de l'objet $ligne sont ici les alias définis 
dans la requête SQL (repère Qi). Le tableau XHTML obtenu est représenté à la figure 16-3. 

Exemple 16-6. Lecture des données dans un objet 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<titl e>Lecture de la table client</title> 
<style type="text/css" > 

table {border-style:double;border-width:3px; border-col or ired; 

^backg round-col or:yel 1 ow; } 

</style> 

</head> 

<body> 

<?php 

incl ude( "connexobjet .inc.php" ) ; 
$idcom=connexobjet( "magasin" , "myparam" ) ; 

$requete="SELECT id_client AS 'Code_client' , nom, prénom, adresse, âge, mail 
^FROM client WHERE ville ='Par1s' ORDER BY nom":<-0 
$result=$idcom->query($ requête) ; 
1f( !$result) 
{ 

echo "Lecture impossible"; 

} 
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else 
{ 

$nbart=$resul t->nuin_rows ; 

echo "<h3> Il y a $nbart clients habitant Paris</h3>": 
//Affichage des titres du tableau 
$titres=$result->fetch_object( ) ; <— 0 
echo "<table border=\"l\"> <tr>": 
foreach($titres as $colonne=>$val ) <— © 
{ 

echo "<th>", $colonne ,"</th>":<— O 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
echo "<tr>": 

$result->data_seek(0) : <— © 

while ($ligne = $result->fetch_object( )) <— © 

{ 

echo"<td>", $ligne->Code_client,"</td>". "<td>". $1 igne->nom, "</td>" , "<td>" , 
^$1 igne->prenom, "</td>" , "<td>" , $1 igne->adresse, "</td>" , "<td>" . $1 igne->age, 
^"</td>","<td>". $ligne->mail , "</td></tr>" ; <-© 

} 

echo "</table>"; 
$resul t->f ree_resul t( ) ; 
$idcom->close( ) ; 
} 

?> 

</body> 
</html> 
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adresse {âge 


1 mail 


10 


|Darc jjeanne 


9 av d'Orléans 1 19 


|null 


1^ 


[Marti [Picrrc 


4 Av Henri \25 


[martin7:2 tiscali.fr 


|2 


^pp |Paul 


32 Av Foch |44 


|rappf§)libert.cotn 



Figure 16-3 

Lecture des noms des colonnes 
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Insertion de données dans la base 



Dans un site interactif, il faut pouvoir enregistrer dans la base de données les informations 
saisies par les visiteurs dans un formulaire XHTML en vue d'une réutilisation ultérieure, 
comme dans le cas des coordonnées complètes d'un client. 

En vous situant, comme au chapitre 15, dans la perspective d'un site de e-commerce, 
vous allez réaliser la saisie puis l'insertion des coordonnées d'un client dans la table 
client de la base magasin. Dans un second temps, nous lui permettrons de mettre à jour 
ces informations. 



Insertion des données 

Le formulaire XHTML est l'outil privilégié pour saisir de données et les envoyer vers le 
serveur PHP/MySQL. Nous disposons désormais de la fonction connexobjet( ) pour 
effectuer la connexion et de la méthode queryO pour l'envoi des requêtes. Seule la 
commande SQL INSERT distingue cette opération de celle de lecture de données. Le 
script de l'exemple 16-7 réalise ce type d'insertion en récupérant les données saisies 
par le client dans un formulaire lors d'une commande. Nous commençons par vérifier 
l'existence des saisies obligatoires correspondant aux variables $_POST[ 'nom' ], $_POST 
[' adresse ' ] et $_POST[ 'ville'] (repère O)- Quand une requête est formée en utilisant les 
saisies faites par l'utilisateur, il est préférable d'utiliser le caractère d'échappement pour 
les caractères spéciaux des chaînes récupérées dans le tableau $_POST, en particulier les 
guillemets, qui peuvent poser problème dans la requête. Nous disposons pour cela de la 
méthode escape_string( ) des objets mysql i dont la syntaxe est : 

I string $idcoin->escape_string(string $chaine) 

La chaîne obtenue contient le caractère d'échappement / devant les caractères spéciaux 
NULL, \n, \r, ', " et Control-Z. 

Le script récupère toutes les saisies et les protège (repères Q à ©). La colonne i d_cl i ent 
de la table client ayant été déclarée avec l'option AUTO_INCREMENT, il faut y insérer la 
valeur NULL en lui donnant la valeur "\N" (repère 0). Le résultat de la requête est ici un 
booléen permettant de vérifier la bonne insertion des données dans la table (repère 0). 
Le script doit communiquer son identifiant au client pour qu'il puisse modifier éventuel- 
lement ses données. La valeur de la colonne id_client est récupérable à l'aide de la 
propriété i nsert_i d de l'objet mysql i . Ce nombre entier est affiché dans une boite d'alerte 
JavaScript (repère ©). 

'•^ Exemple 16-7 Insertion de données 

<!DOCTYPE html PUBLIC " -//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang^'f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Saisissez vos coordonnées</title> 



</head> 
<body> 

<form action= "<?php echo $_SERVER[ ' PHP_SELF' ] ;?>" method="post" 
enctype="appl i cation /x-www-form-url encoded"> 
<fieldset> 

<legend><b>Vos coordonnées</b></legend> 
<table> 

<tr><td>Nom : </td><td><input type="text" name="nom" size="40" maxl ength="30"/> 
^</td></tr> 

<tr><td>Prénoin : </td><td><input type="text" naine="prenom" size="40" 
*»maxlength="30'7></td></tr> 

<tr><td>Age : </td><td><input type="text" name="age" size="40" maxl ength="2"/> 
^</td></tr> 

<tr><td>Adresse : </td><td><input type="text" name^'adresse" size="40" 
*maxlength="60'7></td></tr> 

<tr><td>Ville : </td><td><input type="text" name="ville" size="40" maxlength="40"/> 
^</td></tr> 

<tr><td>Mail : </td><td><input type="text" name="irail" size="40" maxl ength="50"/> 

^</td></tr> 

<tr> 

<td><input type="reset" value=" Effacer "></td> 

<td><input type="submit" value=" Envoyer "></td> 

</tr> 

</table> 

</fieldset> 

</form> 

<?php 

includeC'connexobjet.inc.php" ) ; 

$idcom=connexobjet( 'magasin' , 'myparam' ) ; 

if( !empty($_POST['nom'])&& !empty($_POST[' adresse '])&& 

^!empty($_POST['ville'])) <-© 

{ 

$id_client=''\N''; ^0 

$nom=$idcom->escape_string($_POST[ 'nom' ] ) : <— © 
$prenom=$idcom->escape_stri ng( $_POST[ ' prénom' ] ) ; <— O 
$age=$idcom->escape_string($_POST[ ' âge' ] ) ; <— 0 
$adresse=$idcom->escape_string($_POST[ 'adresse' ] ) ; <— © 
$vil 1 e=$idcom->escape_string($_POST[ ' vil 1 e' ] ) ; <— © 
$mai 1 =$idcom->escape_stri ng( $_POST[ 'mai 1 ' ] ) ; <— © 
//Requête SQL 

$requete="INSERT INTO client VALUES( '$id_client' , '$nom' , 'Sprenom' , '$age' , 

^ ' $adresse' , ' $vi 1 le ' , ' $mai 1 ' ) " ; 

$result=$idcom->query($requete) ; <— © 

if( !$result) 

{ 

echo $idcom->errno; 
echo $idcom->error; 

echo "<script type=\''text/javascript\"> 
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al ert( ' Erreur : " .$idcom->error. " ' )</script>" ; 

} 

el se 
{ 

echo "<script type=\"text/javascri pt\"> 

alert('Vous êtes enregistré Votre numéro de client est : ". 

^$idcom->insert_id. " ' )</script>" ; <— © 

} 

} 

else {echo "<h3>Formul ai re à compléter!</h3>";] 
?> 

</body> 
</html> 

La figure 16-4 illustre la page de saisie et la figure 16-5 la boîte d'alerte JavaScript qui 
donne son identifiant au client. 
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|— Vos coordonnées- 



Nom : 


Engels 




Prénom : 


Jean 




Age: 


55 




Arlresse : 


Rue nompoint 




ViUe: 


Paris 




Mail: 


php5@runhtml.com 





Effooor I [ Envoyer | 



Formulaire à compléter! 



Figure 16-4 

Formulaire d'insertion de données 



Annonce de la page http://Iocalhost ; 




Figure 16-5 

Boite d'alerte JavaScript donnant le numéro de client 
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Mise à jour d'une table 



Un client doit pouvoir modifier ses coordonnées, comme son adresse de livraison ou son 
e-mail. L'exemple 16-8 crée une page contenant un formulaire qui permet la saisie du 
code client dans une zone de texte XHTML (repère O). L'attribut action de l'élément 
<form> renvoie le traitement de la saisie au fichier mysql iex9.php de l'exemple 16-9. La 
page créée est conforme à la figure 16-6. 

Exemple 16-8 Page de saisies des modifications 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtmr' xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Modifiez vos coordonnées</title> 
</head> 
<body> 

<form action^ "mysql iex9. php" method="post" 
^enctype="appl ication/x-www-form-url encoded"> 
<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnées</b></l egend> 
<table><tbody> 
<tr> 

<td>Code client : </td> 

<td><input type="text" name="code" size="20" maxl ength="10"/></td><— © 
</tr> 
<tr> 

<td>Modifier : </td> 

<td><input type="submit" val ue="Modifier"/></td> 
</tr> 

</tbody></table> 
</fieldset> 
</form> 
</body> 
</html> 



£ichier ÉditioQ /^ffichage ^îstonque {^rque-pages QutilE ? 
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tî» _ lm[t//toalhog/chapl6/iiiysqliaa.php ■ù • | |E|-|php53 fi 

Saisissez votre code client pour modifier vos coordonnées 

Code client : 12 

Modifier : | IModifiofi | 



Figure 16-6 

Page de saisie du code client 
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La mise à jour des coordonnées du client est réalisée par le script de l'exemple 16-9. 

La première inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
validé le formulaire sans avoir effectué de saisie (repère Q)- Rappelons, comme nous 
l'avons déjà vu par ailleurs, que cette partie de code PHP doit figurer en tête du fichier 
car elle utilise la fonction header( ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La première crée dynamiquement un 
formulaire permettant la modification des données et la seconde enregistre ces données 
dans la base. 

Lors du premier appel du fichier de l'exemple 16-9, la condition de l'instruction if 
(repère 0) est nécessairement vérifiée car la variable $_POST['modif' ] ne contient rien. 
Elle correspond à la valeur associée au bouton submit du formulaire qui n'est pas encore 
créé. Le script crée une connexion au serveur MySQL pour y lire les coordonnées actuel- 
les du client, dont le code est contenu dans la variable $code issue de la page de saisie de 
l'exemple 16-8 (repère 0). 

La requête SQL sélectionne alors toutes les colonnes de la table cl ient dont l'identifiant 
client (colonne id_client de la table client) correspond à la valeur de la variable $code 
(repère ©), dans le but de compléter le formulaire avec les données actuelles. Cela 
permet de ne saisir que les modifications éventuelles de coordonnées du client, sans 
devoir ressaisir l'ensemble. Ces coordonnées sont lues à l'aide de la méthode f etch_row( ) 
de l'objet Sresult de type mysql i_result, puisque le résultat de la requête SELECT ne 
comporte qu'une seule ligne. Elles sont alors contenues dans la variable $coord de type 
array. Pour afficher les coordonnées dans le formulaire, vous devez attribuer les valeurs 
de ses éléments aux attributs val ue des différents champs <input /> (repère ©). 

La figure 16-7 montre un exemple de création dynamique de formulaire pour le client 
dont l'identifiant vaut 12. Le champ caché code du formulaire permet de passer la valeur 
du code client à la partie du script chargée de l'enregistrement des données modifiées 
(repère Q). 

L'envoi du formulaire utilise la deuxième partie du script, qui met à jour les données du 
visiteur dans la table client après avoir vérifié l'existence de valeurs pour les champs 
obligatoires du formulaire (repère©). Seules les colonnes nom, adresse, ville et mail 
peuvent être mises à jour à l'aide de la requête suivante (repère Q) le reste étant forcé- 
ment inchangé : 

UPDATE client SET noin= ' $nom' , adresse= ' $adresse ' , vil 1 e= ' $v11 1 e ' , 
^ma11 = '$mail ' 
WHERE id_client='$code' 

La vérification du résultat de la requête (repère ©) permet d'afficher une boîte d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas être une impasse, le visiteur est redirigé d'office vers la page 
d'accueil du site index.html (repères Q et ®). 
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'■^ Exemple 1 6-9 Mise à jour de données 

<?php 

if (enipty($_POST[ 'code' ] ) ) {header( "Location :mysql iexS.php" ) ; } <— O 

?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtmr' xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Modifiez vos coordonnées</title> 

<meta http-equiv=''Content-Type" content="text/html ; charset=IS0-8859-r'> 

</head> 

<body> 

<?php 

incl ude( 'connexobjet .inc.php' ) ; 
$idcom=connexobjet( 'magasin' , 'myparam' ) ; 
if($_POST['modif ']! = ' Enregistrer' ) <— © 
{ 

$code=$idcom->escape_string($_POST[ 'code' ] ) ; <— © 

//Requête SQL 

$requete="SELECT * FROM client WHERE id_client='$code' " ; <-© 
$resul t=$idcom->query($ requête) ; 
$coord=$result->fetch_row( ) : <— © 

//Création du formulaire complété avec les données exi stantes <— © 
echo "<form action^ \"". $_SERVER['PHP_SELF']."\" 
^method=\"post\"enctype=\''appl ication/x-www-form-url encoded\''>" ; 
echo "<fieldset>" ; 

echo "<legend><b>Modifiez vos coordonnées</b></l egend>" ; 
echo "<table>"; 

echo "<tr><td>Nom : </td><td><input type^VtextX" name=\"nom\" 

^size=\"40\" maxlength=\"30\" val ue=\''$coord[l]\"/> </td></tr>": 

echo "<tr><td>Prénom : </td><td><input type=\"text\" name=\"prenom\" 

^size=\"40\" maxlength=\"30\" val ue=\"$coord[2]\"/></td></tr>" ; 

echo "<tr><td>Age : </td><td><input type=\"text\" name=\"age\" 

^size=\"4G\" maxlength=\"2\" val ue=\"$coord[3]\"/></td></tr>'' ; 

echo "<tr><td>Adresse : </td><td><input type=\"text\" name=\"adresse\" 

^size=\"40\" maxlength=\"60\" val ue=\''$coord[4]\"/></td></tr>" : 

echo "<tr><td>Ville : </td><td><input type=\"text\" name=\"ville\" 

^size=\"40\" maxlength=\"40\" val ue=\"$coord[5]\"/></td></tr>" : 

echo "<tr><td>Mail : </td><td><input type=\"text\'' name=\"mail\" 

^size=\"40\" maxlength=\"50\" val ue=\''$coord[6]\"/></td></tr>" ; 

echo "<tr><td><input type=\"reset\" value=\" Effacer \"></td> <td><input 

^type=\"submit\" name=\"modif\" val ue=\"Enregi strer\"></td></tr></tabl e>" ; 

echo "</fieldset>"; 

echo "<input type^VhiddenV name^VcodeV" val ue=\"$code\''/>" ; <— © 
echo "</form>": 
$resul t->close( ) ; 
$idcom->cl ose( ) ; 

} 
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el sei f ( i ssetC$_POST[ ' nom' ] )&& i sset ( $_POST[ ' adresse ' ] )&& 

'•isset($_POST['ville'])) ^0 

{ 

//ENREGISTREMENT 

$nom=$idcom->escape_string($_POST[ ' nom' ] ) ; 
$adresse=$idcom->escape_string($_POST[ ' adresse' ] ) ; 
$vi 1 le=$idcom->escape_string($_POST[ ' vin e' ] ) : 
$mail=$idcoin->escape_string($_POST[ 'mail ' ] ) ; 
$age=(integer)$_POST[ 'âge'] : 
$code=$idcom->escape_string($_POST[ ' code ' ] ) ; 
//Requête SQL 

$requete="UPDATE client SET nom='$nom' ,adresse='$adresse' , ville= 
^ '$vi lie' .mail = '$mail ' ,age=$age WHERE id_client='$code"'; <— 0 
$resul t=$idcom->query($ requête) ; 
if(!$result) <-© 

{ 

echo "<script type=\"text/javascript\''> 

al ert( ' Erreur : " .$resul t->error . " ' X/scrlpt)" ; <— ® 

} 

el se 
{ 

echo "<script type=\"text/javascript\"> alertC'Vos modifications 
^sont enregistrées ' ) ;window.location=' index.html ' ;</script>'' ; <— ® 

} 

$resul t->cl ose( ) ; 
$idcom->cl ose( ) ; 

} 

el se 
{ 

echo "Modifier vos coordonnées!"; 

} 

?> 

</body> 
</html> 



Vérification de l'insertion 

La propriété affected_rows de l'objet mysqli contient le nombre de lignes affectées par une mise à 
jour. Elle peut donc nous permettre de savoir si la modification est bien réalisée, car elle doit ici être égale 
à 1 . Au repère © de l'exemple 16-9, vous pourriez donc écrire : 

if ($idcom->affected_rows( ) !=1) 

{//Affichage de 1 'erreur 

} 

el se 

{//Message de confirmation 
} 
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|— Modifiez vos coordonnées - 

Nom : 



Engels 



Prénom : 
Age : 
Adresse : 
Ville: 
Mail: 



Jean 

50 



Rue compoint 
Paris 



php6|@)fiJnhtml.com 



I Effacer [ Enregistre^ 



Figure 16-7 

Formulaire de saisie des coordonnées créé dynamiquement 



Recherche dans la base 

Un site de commerce en ligne doit permettre à ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de données afin d'accéder plus rapidement à l'information 
sur le produit recherché. Il doit en outre permettre d'effectuer des statistiques marketing 
à l'usage du propriétaire du site. Ces recherches concernent aussi bien les sites de 
commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 16-10 crée un formulaire classique permettant de saisir un mot-clé et 
d'effectuer des choix de tri des résultats. Les critères de tri selon le prix, la catégorie ou 
l'identifiant d'article sont affichés sous forme de liste déroulante. Le choix de l'ordre 
croissant ou décroissant s'effectue au moyen de deux boutons radio ayant le même attri- 
but name, ce qui les rend exclusifs l'un de l'autre. 

Le script contrôle d'abord que le visiteur a saisi un mot-clé dans le formulaire en véri- 
fiant que la variable $_POST["motcle'] n'est pas vide (repère Q)- H récupère ensuite le 
mot-clé, la catégorie, le critère de tri et l'ordre d'affichage, respectivement dans les varia- 
bles $motcle, $categorie, $ordre et $tri (repères 0 à 0). 

Si la catégorie choisie est "tous", la partie de la commande WHERE concernant cette catégo- 
rie est vide. Pour les autres choix, elle est égale à "AND categorie=$categorie" (repère ©). 
La requête de sélection suivante (repère est alors créée par le code : 

"SELECT icl_article AS 'Code article', 
désignation AS 'Description', 
prix, catégorie AS 'Catégorie' 

FROM article WHERE lower(designation) LIKE'%$motcle%'".$reqcategorie. 
"ORDER BY $tri $ordre"; 
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On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche insensible à la casse. De cette façon, que l'utilisateur cherche les mots-clés 
« sony » ou « Sony », il obtiendra bien les résultats présents dans la table a rti cl e. 

L'utilisation d'alias donne un meilleur affichage des titres du tableau de résultats. Après 
la connexion au serveur, vous récupérez le résultat de la requête dans la variable $ resuit. 
La lecture des résultats et l'affichage de toutes les lignes retournées sont réalisés avec la 
méthode f etch_row( ) (repère Q). La figure 16-8 illustre la page créée après la recherche 
du mot-clé portable. 

'•^ Exemple 16-10. Page de recherche d'articles 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtcl"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<nteta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER['PHP_SELF']?>" method="post" 

^enctype="appl ication/x-www-form-url encoded"> 

<fieldset> 

<1 egend><b>Rechercher un article en magasin</b></legend> 

<table> 

<tbody> 

<tr> <td>Mot-cl&#233:: </td> 

<td><input type="text" name="motcl e" size="40" maxlength="40" 

^value="<?php $_POST[ 'motel e']?>"/></td> 

</tr> 

<tr> 

<td>Dans la cat&#233:gorie : </td> 
<td> 

<select name="categorie"> 

<option val ue=" tous" >Tous</option> 

<option value="vidéo">Vid&#233:D</optiDn> 

<option val ue="inforniatique">Informatique</option> 

<option val ue= " photo ">Photo</option> 

<option val ue= "divers ">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 
<td> 

<select name="tri"> 

<option val ue="prix">Prix</option> 

<option value="categorie">Catégorie</option> 

<option value="id_article">Code</option> 

</select> 

</td> 



</tr> 

<tr><td>En ordre: </td> 

<td>Croissant<input type="radio" nanie="ordre" value="ASC" checked="checked"/> 
^Décroissant<input type="radio" name="ordre" value="DESC" /> 
</td> </tr> 

<tr><td>Envoyer</td><td><input type="submit" name="" val ue="OK"/></td></tr> 
</tbody> 
</table> 
</fieldset> 
</form> 
<?php 

if(!enipty($_POST['motcle'])) <-© 
{ 

includeC 'connexobjet.inc.php' ) ; 
$motcle=($_POST['motcle']): <-© 
$categorie=($_POST[ 'catégorie' ] ) ; <— 0 
$ordre=($_POST['ordre']); 
$tri = ($_POST['tri ']); ^0 

//Requête SQL 

$reqcategorie=($_POST[ 'catégorie' ]=="tous" )?"" : "AND categorie='$categorie' " ; <— 
$requete="SELECT id_article AS 'Code article' .désignation AS 'Description' .prix 
^catégorie AS 'Catégorie' FROM article WHERE lower(designation) 
^LIKE'^$motcle^"'.$reqcategorie."ORDER BY $tri $ordre";<— 0 
$idcom=connexobjet( 'magasin' . 'myparam' ); 
$result=$idcom->query($requete) ; <— 0 
if( !$result) <— 0 
{ 

echo "Lecture impossible"; 

} 

e1 se 
{ 

$nbcol =$resul t->f iel d_count ; 
$nbart=$resul t->num_rows ; 
$titres=$result->fetch_fields( ) ; 

echo "<h3> Il y a $nbart articles correspondant au mot-clé : $motcl e</h3>" 
//Affichage des titres du tableau 
echo "<table border=\''l\"> <tr>": 
foreach($titres as Snomcol =>$val ) 
{ 

echo "<th>", $titres[$nomcol ]->name ."</th>"; 

} 

echo "</tr>": 

//Affichage des valeurs du tableau 
for($i=0:$i<$nbart:$i++) 

{ 

$1 igne=$resul t->fetch_row( ) ; 
echo "<tr>"; 

for($j=0;$j<$nbcol :$j++) 
{ 

echo "<td>" .$1 igne[$j] . "</td>" ; 
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] 

echo "</tr>"; 

} 

echo "</table>"; 
$result->close( ) ; 
$idcom->close( ) ; 

} 

} 

?> 

</body> 
</html> 
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Rechercher un article en magasin - 

Mot-cle: portable 



Dans la catégorie ; | Informatique 1 • 

Trier par : Prix » 

tn ordre: Croissant • Décroissant 

Envoyer OK i 



n y a 3 aitides conespondant au uiot-clé : portable 



Code article 


Descripliun , 


prix 


Calégurie 


DEL30 


Portable Dell X300 


1715.00 


informatique 


SAX15 


Portable Samstmg X15 X\'M 


1999.00 


informatique 


SOXMP j 


PC Portable Sony Zl-XMP 


2399.00 


informatique 



Figure 16-8 

Formulaire de recherche et résultats obtenus 



Les requêtes préparées 

Nous avons déjà construit des requêtes SQL dynamiquement à partir d'informations 
saisies par l'utilisateur dans l'exemple précédent. Les requêtes préparées permettent de 
créer des requêtes SQL qui ne sont pas directement utilisables mais qui contiennent des 
paramètres auxquels on peut donner des valeurs différentes en fonction des besoins, pour 
des appels répétitifs par exemple. Une requête préparée peut se présenter sous la forme 
suivante : 

I SELECT prénom, nom FROM client WHERE ville=? AND icl_client>=? 
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Dans cette requête, les caractères ? vont être remplacés par des valeurs quelconques en 
fonction des besoins du visiteur. 

La démarche à suivre pour utiliser une requête préparée est la suivante : 

1. Écrire la chaîne de requête comme paramètre de la méthode prepareO de l'objet 
mysql i. Cette dernière retourne un objet de type mysql i_stmt qui représente la requête 
préparée. 

2. Lier les paramètres dans l'ordre de leur apparition avec des valeurs ou des variables à 
l'aide de la méthode bind_param( ) de l'objet mysql i_stmt, selon la syntaxe : $mysqli_ 
stmt->bind_param(string $types, $paraml, . . .SparamN). 

La chaîne Stypes est la concaténation de caractères indiquant le type de chacun des 
paramètres. La signification de ces caractères est présentée au tableau 16-2. 



Tableau 16-2. Signification des caractères de la chaîne Stypes 


Caractère 


Définition 


1 Entier (integer) 


d 


Décimal 


s 


Chaîne de caractères (string) 


b 


Blob (texte long) 



3. Pour trois paramètres qui seraient, dans l'ordre d'apparition dans la requête, un déci- 
mal, une chaîne et un entier, la chaîne Stypes serait par exemple "dsi ". 

4. Exécuter la requête en appelant la méthode execute( ) de l'objet mysql i_stmt. 

5. Pour les requêtes préparées qui retournent des résultats, comme SELECT, il faut ensuite 
lier les résultats à des variables PHP, avec la méthode bind_resul t( ) selon la syntaxe : 
mysqli_stmt->bind_result($varl, . . .$varN) avec autant de paramètres qu'il existe de 
colonnes lues dans la requête. L'objet mysql i_result obtenu contient alors toutes les 
lignes du résultat. 

6. Lire ces lignes à l'aide d'une boucle en appliquant la méthode fetch( ) à cet objet et 
utiliser ces résultats pour un affichage avec les noms des variable définies à l'étape 4. 

7. Libérer la mémoire occupée par l'objet mysql i_stmt avec la méthode free_result( ). 

L'exemple 16-11 présente une application de requête préparée dans laquelle ce sont les 
saisies d'un utilisateur qui déterminent les valeurs des paramètres et donc la requête 
finale. Un formulaire classique demande la saisie d'un nom de ville et d'un numéro de 
client (repères O et 0) dans le but de trouver tous les clients habitant cette ville et dont 
l'identifiant est supérieur ou égal à la valeur saisie. Ces saisies sont d'abord récupérées 
dans les variables $ville et $id_client (repères 0 et Q). Après la connexion à la base, 
nous écrivons la requête préparée avec la méthode prepareO (repère 0), nous lions les 
paramètres de type string et integer aux variables $ville et $id_client (repère ©), puis 
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nous exécutons la requête ainsi complétée en appelant la méthode exécute ( ) (repère Q). 
Comme il s'agit d'une requête SELECT, elle retourne une ou plusieurs lignes contenant 
chacune deux valeurs que nous lions aux variables Sprenom et $nom (repère ©). Les diffé- 
rentes lignes sont alors lues et affichées avec une boucle while en appelant la méthode 
fetchO (repère 0), les valeurs cherchées étant contenues dans les variables $prenom et 
$nom. La mémoire est ensuite libérée (repère ©) et l'objet mysql i supprimé (repère ©). 

'■^ Exemple 16-11 Utilisation des requêtes préparées 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<nieta http-equiv="CDntent-Type" content="text/html ; charset=isD-8859-l" /> 

<title>Recherche de client</title> 

<style type="text/css" > 
div{font-size: 16px;) 

</style> 
</head> 
<body> 

<form method="post" action="mysqliexll.php"> 
<fieldset> 

<legend>Recherche de cl ient</legend> 

<label>Ville </label> 

<inpLit type="text" name="ville" /Xbr /> <— 0 
<label>Id_client</label> 
<input type="text" name="id_client" /> <— 0 
<input type="subm1t" val Lie="Envoyer" /> 
</fieldset> 
</form> 
</body> 
</html> 
<?php 

if(isset($_POST['ville']) && isset($_P0ST['1d_client'])) 
{ 

$ville=strtolower($_PQST[' ville']): <— © 
$i d_cl i ent=$_POST[ ' 1 d_cl i ent ' ] : <-© 
includeC 'connexobjet.inc.php' ) : 
$idcom=connexobjet( 'magasin' , 'myparam' ) ; 

$reqprep=$idcom->prepare( "SELECT prénom, nom FROM client WHERE lower(ville)=? 
*AND id_client>=? ");<—© 

$reqprep->bind_param( "si " , $vi 1 1 e,$id_cl ient) ; <— © 
$reqprep->execute( ) : <— © 
$reqprep->bind_result($prenDm,$nom) ; <— © 

echo "<div><h3>Cl ient(s) habitant à ", ucf i rst($vil 1 e) , " et dont l'identifiant est 
**supérieur à $id_client</h3>": 

//Affichage des résultats 
while ($reqprep->fetch( ) ) <— © 
{ 

echo "<h3> Sprenom $nom</h3>"; 
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echo "</div>"; 

$reqprep->f ree_resul t( ) ; <— © 
$idcoin->cl ose( ) ; <— © 



} 

?> 



Avec notre base de données magasin et les paramètres « Paris » et « 3 », nous obtenons 
par exemple l'affichage présenté à la figure 16-9 



>rche de client - Mozilla Firefox i 



Fichier Édition Affichage Historique Marque-pages Outils ? 



C X fîï ( U I htlpV/localhoa/chapl6/mysqliedl.pfip ■Ç] - 1 ||G|'|googfe <P| 



-Recherche de client - 



Ville Paris 



Id_clicnt 3 
[ . ..Envoyer .] 



CUent($) habitant à Paris et dont l'identiQant est supérienr à 3 
Pierre Marti 
Jeanne Darc 



Figure 16-9 

Résultats d'une requête préparée 



Les transactions 

Dans l'exemple de notre base magasin, si un client effectue un achat, il faut réaliser 
simultanément deux insertions : une dans la table commande et une dans la table 1 igne. Si, 
pour une raison quelconque, matérielle ou logicielle, la seconde insertion n'est pas réali- 
sée alors que la première l'est déjà, la base contiendra une incohérence car il existera une 
commande ne comportant aucune ligne. L'inverse ne serait guère préférable car, dans ce 
cas, il existerait une ligne qui ne serait reliée à aucune commande. Les transactions 
permettent de gérer ce genre de situation en effectuant des commandes « tout ou rien » ce 
qui, en pratique pour notre exemple ci-dessus, signifie que si l'une des deux requêtes 
n'est pas exécutée, aucune ne l'est. L'intégrité de la base s'en trouve préservée. 

Le langage SQL possède des commandes qui permettent de gérer les transactions, mais 
l'extension mysqli nous fournit des méthodes qui permettent de gérer les transactions 
sans y faire appel. 
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Dans l'exemple 16-12, nous illustrons la procédure à suivre pour effectuer deux requêtes 
INSERT dans la table arti cl e. Par défaut, le mode autocommi t de MySQL est activé, ce qui 
signifie que chaque requête est automatiquement validée. Il nous faut donc le désactiver 
au moyen de la méthode autocommi t( ) de l'objet mysqli avec pour paramètre la valeur 
FALSE (repère O). A partir de cet instant, les deux requêtes d'insertion que nous voulons 
réaliser (repères Q et 0) ne seront validées que si nous effectuons explicitement la vali- 
dation au moyen de la méthode commitC ) (repère ©), ou bien l'ensemble sera annulé en 
appelant la méthode roi 1 back( ) de l'objet mysql i (repère Q). Pour choisir de valider ou 
annuler les insertions, nous comptons le nombre total de lignes insérées dans la base en 
lisant la propriété af f ected_rows (repères Q et 0). S'il est bien égal à 2, la validation est 
effectuée (repère©), sinon tout est annulé et un message d'information s'affiche 
(repère 0). 

Pour tester l'efficacité du mécanisme, il suffit de créer une erreur en écrivant par exemple 
dans la variable $requete2 le nom articles, au lieu de article, comme nom de table 
inexistante. L'affichage de la table article avec phpMyAdmin permet de vérifier que 
même la première requête, qui était correcte, n'a pas été exécutée. 

Exemple 16-12 Insertions avec transaction 

<?php 

incl ude( 'connexobjet.inc.php' ) ; 
$idcom=connexobjet( 'magasin' , 'myparam' ); 
$idcom->aLitocommit( FALSE) ; <— 0 

Srequetel^'INSERT INTO article VALUES CAZERT', 'Lecteur MP3', 59.50. 
^'divers'):": ^0 

$requete2=''INSERT INTO article VALUES CQSDFG'. 'Bridge Samsung 10 Mo'. 358.90. 
^'photo'):"; <— 0 

//pour empêcher la validation écrire articles au lieu de article 

$idcom->query($requetel) ; 
$nb=$idcom->affected_rows : <— © 
echo "LIGNES INSEREES" ,$nb."<hr />"; 
$idcom->query($requete2) : 
$nb+=$idcom->affected_rows ; <— 0 
if($nb==2) 
{ 

$idcom->commit( ) : <— 0 
echo $nb." lignes insérées": 

} 

el se 
{ 

$idcom->ronback( ) ; <— 0 
echo "transaction annulée"; 

} 

?> 
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Mémo des méthodes et propriétés 

Classe mysqli : méthodes 

mysqli ( [string $host [, string Susername [, string $passwd [, string $base [, int $port [, 

string $socket]]]]]] ) 

} 

Crée un objet mysqli. 

boolean autocommit ( boolean $mode ) 

Active ($mode =TRUE) ou désactive ($niode=FALSE) le mode autocommit. 
boolean ctiange_user ( string $Liser, string $password, string $base ) 
Ctiange l'utilisateur de la connexion et retourne TRUE en cas de réussite et FALSE sinon, 
boolean close (void) 

Ferme la connexion et retourne TRUE en cas de réussite et FALSE sinon, 
boolean commit ( void ) 

Valide la transaction courante et retourne TRUE en cas de réussite et FALSE sinon, 
string escape_string ( string $ctiaine ) 

Crée une ctiaîne SQL valide qui pourra être utilisée dans une requête SQL. La chaîne de caractères $ctiai ne est enco- 
dée en une ctiaîne SQL éctiappée, en tenant compte du jeu de caractères courant de la connexion. 

boolean kill ( int $processid ) 

Demande au serveur de terminer un ttiread MySQL identifié par son identifiant. 

boolean multi_query ( string $query ) 

Exécute une ou plusieurs requêtes, rassemblées dans le paramètre query par des points-virgules, 
boolean ping ( void ) 

Teste la connexion pour s'assurer que le serveur est bien en fonctionnement. S'il ne fonctionne pas et que l'option globale 
mysql i . reconnect est activée, une connexion automatique sera tentée avec les derniers paramètres utilisés. 

objet mysql i_stmt prépare ( string $query ) 

Prépare une requête SQL et retourne un objet mysql i_stmt. 

divers query ( string $query [, int $mode] ) 

Exécute une requête sur la base de données. $niode est une constante qui vaut MYSQLI_USE_RESULT ou MYSQLI_STORE_ 
RESULT (par défaut), suivant le comportement désiré. Retourne TRUE en cas de succès, FALSE en cas d'échec. Pour 
SELECT, SHOW, DESCRIBEou EXPLAIN retourne un objet mysql i_resul t. 



boolean rollback ( vcid ) 




Annule la transaction courante. 




boolean select_db ( string $base ) 




Sélectionne une base de données. 




string stat ( void ) 



Retourne une chaîne de caractères contenant des informations sur la connexion ouverte : le temps de fonctionnement, 
exprimé en secondes, le nombre de threads courant, le nombre de commandes, les tables rechargées et ouvertes. 
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objet mysql i_resul t store_result ( void ) 

Stocke un ensemble de résultats dans un objet mysql i_resul t à partir de la dernière requête. 

Classe mysqli : propriétés 

integer affected_rows 

Contient le nombre de lignes affectées par la dernière requête INSERT, UPDATE, REPLACE ou DELETE. 
integer errno 

Contient un code d'erreur pour la dernière commande SQL. 
integer error 

Contient une chaîne décrivant la dernière erreur, 
integer field_count 

Contient le nombre de colonnes concernées dans la dernière requête, 
integer insert_id 

Contient l'identifiant automatiquement généré pour un attribut déclaré AUTO_INCREMENT ou 0 sinon. 
thread_id 

Contient l'identifiant du thread pour la connexion en cours, 
integer warning_count 

Contient le nombre d'avertissements générés par la dernière requête. 



Classe mysqli_result : méthodes 

boolean close ( void ) 

Supprime l'objet résultat. 

boolean data_seel<(integer N) 

Déplace le pointeur interne de résultat à la position N. 

divers fetcfi_array ( [integer $type] ) 

Retourne un tableau qui correspond à la ligne récupérée, ou NULL s'il n'y a plus de ligne dans le résultat. Le paramètre 
$type détermine le type du tableau ; il vaut MYSQLI_ASSOC, MYSQLI_NUM ou MYSQLI_BOTH respectivement pour 
obtenir un tableau associatif, indicé ou mixte. 

array fetcli_asscc ( void ) 

Retourne une ligne de résultat sous forme de tableau associatif, 
object fetcfi_field ( void ) 

Retourne un objet qui contient les caractéristiques d'un attribut de table, 
array fetcli_fields ( void ) 

Retourne un tableau d'objets qui contient les caractéristiques de tous les attributs de table présents dans une requête. 
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object fetch_object (void) 

Retourne un objet dont les propriétés sont les noms des colonnes utilisées dans la requête ou NULL s'il n'y a plus de iigne 
dans ie résultat. 

divers fetcln_row ( void ) 

Retourne un tableau indicé contenant une ligne de résultat ou NULL s'il n'y a plus de ligne de résultat. 

boolean field_seel< ( int N ) 

Place le pointeur de résultat sur le champ N. 

void free_result ( void ) ou void close ( void ) 

Libère la mémoire associée à l'objet résultat. 

Classe mysqli_result : propriétés 

integer field_count 

Contient le nombre de colonnes pour la dernière requête, 
int nuiii_rows 

Retourne le nombre de lignes d'un résultat. 

Classe mysqli_stmt : méthodes 

boolean bind_parani ( string $types, divers $varl [...divers $varN] ) 
Lie des variables à une requête SQL préparée avec la méthode prepare( ). 
boolean bind_result (divers $varl [....divers $varN] ) 

Associe des variables à un résultat de requête préparée et retourne TRUE en cas de réussite ou FALSE sinon, 
boolean close ( void ) 

Termine une requête préparée et retourne TRUE en cas de réussite ou FALSE sinon. 

void data_seek ( integer N) 

Déplace le pointeur de résultat à la position N. 

boolean exécute ( void ) 

Exécute une requête préparée et retourne TRtJE en cas de réussite ou FALSE sinon, 
boolean fetcti ( void ) 

Lit des résultats depuis une requête MySQL préparée dans les variables liées. 

void free_result ( void ) 

Libère le résultat de la mémoire. 

divers prépare ( string Irequete ) 

Prépare une requête SQL et retourne TRUE en cas de succès, FALSE en cas d'échec, 
boolean reset ( void ) 

Annule une requête préparée et retourne TRUE en cas de succès, FALSE en cas d'échec. 
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Classe mysqli_stmt : propriétés 

integer affected_rows 

Contient le nombre total de lignes concernées par la dernière requête, 
integer errno 

Contient un code erreur pour la dernière requête préparée, 
string error 

Contient la description de la dernière erreur, 
integer field_count 

Contient le nombre de colonnes dans la requête, 
integer insert_id 

Contient l'identifiant généré par la dernière requête INSERT pour la colonne AUTO_INCREMENT. 
integer num_rows 

Contient le nombre de lignes d'un résultat de requête préparée, 
integer param_count 

Contient le nombre de paramètres nécessaires dans la requête préparée. 



Exercices 

Tous les exercices ci-dessous portent sur la base de données voitures créée aux chapi- 
tres 13 et 14. Ils sont identiques à ceux du chapitre 15, mais vous devez les réaliser 
uniquement avec l'extension rtiysql i objet. 

Exercice 1 

Créez un script permettant d'afficher le contenu de la table modèle dans un tableau 
XHTML. Les résultats doivent être triés par marque. 

Exercice 2 

Créez un formulaire permettant l'insertion de nouvelles données dans la table model e. 
Exercice 3 

Créez un formulaire permettant l'insertion simultanée des coordonnées d'une personne 
dans les tables propriétaire et cartegrise. Il doit contenir les zones de saisie des coor- 
données de la personne et la liste des modèles d'une marque créée dynamiquement à 
partir de la saisie de la marque. 

Exercice 4 

Créez un formulaire de recherche permettant de retrouver tous les propriétaires d'un type 
de véhicule de marque et de modèle donnés. Affichez les résultats sous forme de tableau 
XHTML. 
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Exercice 5 

Créez un formulaire de recherche permettant de retrouver tous les véhicules possédés par 
une personne donnée. Affichez les résultats sous forme de tableau XHTML. 

Exercice 6 

Réécrivez entièrement le code de l'exercice 5 en récupérant tous les résultats dans des 
objets et en manipulant leurs propriétés. 

Exercice 7 

Refaire l'exercice 4 en utilisant une requête préparée. 
Exercice 8 

Refaire l'exercice 3 en utilisant une transaction pour s'assurer que les données sont bien 
insérées dans les différentes tables. 



17 

PDO et MySQL 



PDO (PHP Data Objects) est une extension qui offre une couche d'abstraction de 
données introduite dans PHP 5, ce qui signifie qu'elle n'est pas liée, comme les exten- 
sions mysql ou mysqli que nous avons abordées dans les deux chapitres précédents, 
mais indépendante de la base de données utilisée. Grâce à elle, le code devient portable 
très facilement, c'est-à-dire qu'elle modifie uniquement la ligne de connexion, d'une 
base de données MySQL à SQLite, PostgreSQL, Oracle et d'autres encore par exemple. 
PDO offre donc aussi bien l'avantage de la portabilité, de la facilité d'utilisation que de 
la rapidité. 

L'extension PDO comprend les trois classes suivantes : 

• La classe PDO, qui permet de créer des objets représentant la connexion à la base et qui 
dispose des méthodes permettant de réaliser les fonctions essentielles, à savoir l'envoi 
de requête, la création de requêtes préparées et la gestion des transactions. 

• La classe PDOStatement, qui représente, par exemple, une requête préparée ou un résul- 
tat de requête SELECT. Ses méthodes permettent de gérer les requêtes préparées et de 
lire les résultats des requêtes. 

• La classe PDOException qui permet de gérer et d'afficher des informations sur les 
erreurs à l'aide d'objets. 

Ce chapitre reprend exactement la même démarche que le précédent en utilisant exclusi- 
vement PDO ; nous allons y reprendre les différents exemples des chapitres 15 et 16 et 
voir comment obtenir les mêmes résultats via un accès objet PDO. Il peut donc être abordé 
indépendamment des deux chapitres précédents. 
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Connexion au serveur MySQL 

Bien entendu, la première chose à faire est de se connecter au serveur. Pour cela nous 
créons un objet de la classe PDO en utilisant le constructeur de la classe PDO dont les para- 
mètres changent selon le serveur auquel nous nous connectons. Par exemple : 

• Pour MySQL : 

[ $idcoin= new PDO( "mysql : host=$host ;dbname=$base ,$user,$pass) ; 

• Pour SQLite : 

[ $idcoin= new PD0("sqlite2:/chemin/rep/$base") ; 

• Ou encore pour PostgreSQL, que nous n'utiliserons pas, ce qui illustre la portabilité de 
PDO : 

I$idcoin= new PDO( "pgsql : host=$host port=5432 dbname^Sbase user=$user 
^password=$pass" ) . 

Dans ces exemples, $idcom est un objet PDO. $host, $user, $pass et $base, quant à eux 
désignent, comme dans les chapitres précédents, le nom du serveur, l'utilisateur, le mot 
de passe et le nom de la base. 

Nous pouvons également réutiliser le fichier myparam.inc.php créé au chapitre 15, conte- 
nant les paramètres de connexion (ci-dessous en local) : 

'•^ Exemple 1 7-1 . Le fichier myparam.inc.php 

<?php 

def i ne( "MYHOST" . "1 ocal host" ) ; 

define("MYUSER"."root"); 

defineC'MYPASS",""): 

?> 

L'objet $idcom représentant la connexion sera utilisé directement ou indirectement pour 
toutes les opérations à effectuer sur la base. Si la connexion n'est pas effectuée, la varia- 
ble Sidcom est un booléen qui contient la valeur FALSE. ce qui permet de tester si la 
connexion est bien réalisée. 

La connexion prend fin quand l'exécution du script PHP est terminée, mais on peut 
mettre fin explicitement à la connexion pour libérer le serveur MySQL. Si les résultats 
d'une requête sont entièrement récupérés, la connexion peut en effet être détruite en 
donnant à la variable $idcom la valeur NULL. 



Sélection de la base via SQL 

Comme nous l'avons vu au chapitre 15, vous pouvez aussi sélectionner une base en envoyant la requête 
"USE nom_base" au serveur à l'aide de la méthode query( ) détaillée dans les sections suivantes. 



La structure de principe d'un script accédant à MySQL est donc la suivante : 
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<?php 

//Inclusion des paramètres de connexion 
incl ude_once( "myparam.inc.php") ; 

//Connexion au serveur 

$dsn="mysql : host=" .MYHOST. " ;dbname=" .$base; 

$user=MYUSER; 

Spass^MYPASS; 

$idcom = new PDO($dsn,$user,$pass) ; 

//Contrôle de la connexion 

if( !$idconi) 

{ 

echo "Erreur"; 

} 

//Requêtes SQL sur la base choisie 
//Lecture des résultats 

//Fermeture de la connexion 

$idcom=NULL: 

?> 

Comme nous l'avons fait pour l'accès procédural à MySQL, nous avons intérêt à créer 
une fonction de connexion au serveur que nous réutiliserons systématiquement dans 
tous les exemples qui suivent. C'est l'objet de l'exemple 17.2 qui crée la fonction 
connexpdo( ), dont les paramètres sont le nom de la base dans la variable $base et le nom 
du fichier .inc.php qui contient les paramètres de connexion dans la variable $param. 

La fonction inclut d'abord les paramètres de connexion (repère O), définit la chaîne 
DSN (Data Source Name) pour MySQL (repère 0), puis crée un objet PDO dans un bloc 
try (repère 0). En cas d'échec, un bloc catch crée un objet PDOException (repère qui 
permet d'afficher un message d'erreur en appelant la méthode getMessage( ) (repère 0). 
Si la connexion est bien réalisée elle retourne l'objet $idcom ou FALSE dans le cas 
contraire. 



Exemple 17-2. Fonction de connexion au serveur 

<?php 

function connexpdo($base,$param) 
{ 

incl ude_once($param. ". inc.php" ) ; <— O 
$dsn="mysql :host=".MYHOST.": <-© 
dbname=".$base; 
$user=MYUSER; 
$pass=MYPASS; 
try 
{ 

$idcom = new PDO($dsn,$user,$pass): <— 0 
return Sidcom; 

} 

catchCPDOException Sexcept) <— O 
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{ 

echo"Echec de la connexion" ,$except->getMessage( ); <—@ 

return FALSE; 

exitO: 

) 

} 

?> 

Chacun de vos scripts d'accès à la base doit de ce fait contenir les lignes suivantes : 

Ii ncl ude ( "connexpdo . i ne . php" ) 
Sidcom = connexpdo ( "noin_base" , "inyparam ") ; 

L'opération de connexion est donc là aussi gérée en 2 lignes, quel que soit le script ou le 
type de base. 

Envoi de requêtes SQL au serveur 

Les différentes opérations à réaliser sur la base MySQL impliquent l'envoi de requêtes 
SQL au serveur. 

Pour envoyer une requête au serveur, nous avons le choix entre plusieurs méthodes. 

Pour celles qui ne retournent pas de résultats, il existe la méthode exec( ) des objets PDO 
dont la syntaxe est la suivante : 

I integer $idcom->exec(string requête) 

Elle est utilisée pour les requêtes INSERT, UPDATE ou DELETE par exemple. Elle retourne 
simplement un entier qui correspond au nombre de lignes concernées par la requête. 

Pour les requêtes qui vont retourner des résultats, il faut employer la méthode query( ), 
dont la syntaxe est : 

I object $idcoin->query(string Srequete) 

Elle retourne FALSE en cas d'erreur ou, sinon, un objet de la classe PDOStatement représen- 
tant l'ensemble des lignes de résultats - pour lequelles il faut ensuite appeler les métho- 
des spécialisées pour afficher les valeurs. En résumé, un script d'envoi de requêtes se 
présente sous la forme suivante : 

'•^ Exemple 17-3 Envoi type de requête 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html : charset=utf-8" /> 

<title>Insertion et lecture de la table cl ient</title> 

</head> 

<body> 

<?php 
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incl ude_once( "connexpdo. inc.php" ) ; <— O 
$iclcom=connexpdo("niagasin" ."myparam") ; <— 0 
//Requête sans résultats 

$requetel="UPDATE client SET age=43 WHERE id_cl ient=7" ; <-0 
$nb=$idcom->exec($requetel); <— O 

echo "<p>$nb ligne(s) modifiée(s)<hr /></p>";<— 0 
//Requête avec résultats 

$requete2="SELECT * FROM client ORDER BY nom":<-0 
$result=$idcoin->query($requete2) ; <— 0 
if(!$result) <-0 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcoin->errorCode( ) , $ines_erreur[2] ; 

} 

else <— 0 
{ 

while ($row = $result->fetch(PDO: :FETCH_NUM)) 

{ 

foreach($row as $donn) 
{ 

echo $donn , "  " : 

} 

echo "<hr />"; 

} 

$resul t->cl oseCursorC ) ; <— © 

} 

$idcom=nul 1 ; 
?> 

</body> 
</html> 

Il effectue successivement l'inclusion du fichier connexpdo. inc. php (repère 0), la 
connexion au serveur (repère 0), l'écriture d'une première requête SQL dans la variable 
$requetel (repère 0) et son envoi à l'aide de la méthode exec( ), qui retourne le nombre 
de lignes affectées dans la variable $nb (repère 0) et son affichage (repère 0). Une 
seconde requête contenant la commande SELECT (repère 0) est envoyée via la méthode 
queryO qui retourne un résultat dans la variable Sresult - qui est un objet de type 
PDOStatement (repère 0). Un test permet de vérifier la bonne exécution de la requête et 
l'affichage des résultats au moyen de méthodes que nous développerons dans les sections 
suivantes (repères 0 et 0). Enfin, pour libérer la mémoire occupée par le résultat 
obtenu, nous utilisons la méthode closeCursorO de l'objet PDOStatement, surtout utile 
avant d'envoyer une nouvelle requête SELECT au serveur (repère ©)■ 



Lecture du résultat d'une requête 

Pour les opérations d'insertion, de suppression ou de mise à jour des données dans une 
base, il est utile de vérifier si la requête a bien été exécutée ou, comme dans l'exem- 
ple 17-3, de vérifier le nombre de lignes affectées. 
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En revanche, lorsqu'il s'agit de lire le résultat d'une requête contenant la commande 
SELECT, la méthode queryO retourne un objet de type PDOStatement identifié dans nos 
exemples par la variable $ resuit. La classe PDOStatement offre une variété de méthodes qui 
permettent de récupérer des données sous des formes diverses, la plus courante étant un 
tableau mais cela peut également être un objet. 

Lecture à l'aide d'un tableau 

La méthode des objets PDOStatement la plus courante pour lire des données dans un 
tableau est fetch( ) dont la syntaxe est : 

I array $result->fetch(integer type) 

Elle retourne un tableau qui peut être indicé (si la constante type vaut PDO: :FETCH_NUM), 
associatif (si type vaut PDO: : FETCH_ASSOC), dont les clés sont les noms des colonnes ou 
les alias de la table interrogée, ou encore mixte contenant à la fois les indices et les clés 
(si type vaut PDO: : FETCH_BOTH). Pour lire toutes les lignes du résultat, il faut écrire une 
boucle (while par exemple) qui effectue un nouvel appel de la méthode fetchO pour 
chaque ligne. Cette boucle teste s'il y a encore des lignes à lire, la méthode fetchO 
retournant la valeur NULL quand il n'y en a plus. Pour lire et afficher chaque ligne, nous 
utilisons ensuite une boucle f oreach. Notez encore une fois que si le tableau retourné est 
indicé, l'indice 0 correspond au premier attribut écrit dans la requête, et ainsi de suite. 

Nous pouvons également récupérer toutes les lignes de résultats dans un seul tableau 
multidimensionnel pour lequel le premier niveau est indicé de 0 à N-1 pour lire N lignes, 
chaque élément étant lui même un tableau qui peut être indicé, associatif ou mixte selon 
la valeur du paramètre type qui prend les mêmes valeurs que pour la méthode fetchO. Il 
s'agit de la méthode fetchAll () qui sera mise en œuvre dans l'exemple 17-5 et dont la 
syntaxe est : 

I array $result->fetchAn (integer type) 

L'exemple 17-4 met cette méthode en pratique dans le but d'afficher le contenu de la 
table article de la base magasin dans un tableau XHTML. Après l'inclusion de la fonction 
de connexion (repère 0)> puis son appel sur la base magasin (repère 0), nous écrivons la 
requête SQL de sélection (requête©). L'envoi de la requête avec la méthode queryO 
permet de récupérer un objet $result ou FALSE en cas d'échec (repère ©). Un test sur la 
variable Sresult (repère©) permet d'afficher un message d'erreur (repère©) ou le 
contenu de la table (repère ©). Nous récupérons d'abord le nombre d'articles dans la 
table grâce à la méthode rowCountO de l'objet PDOStatement (repère©) et affichons ce 
nombre dans un titre <h4> (repère ©). Une boucle while permet de lire une ligne à la fois 
dans un tableau indicé (repère ®), puis une boucle foreach permet d'afficher chacune 
des valeurs du tableau dans un tableau XHTML (repère©). L'objet $result est alors 
supprimé (repère©) et la connexion fermée (repère©). La figure 17-1 illustre l'affi- 
chage obtenu dans un navigateur. 
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f*' Exemple 17-4. Lecture de la table article 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtnilll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table arti cl e</titl e> 
<style type="text/css" > 

table {border-style:doLible;border-width: 3px;border-color:red: 

^background-color: yellow;) 

</style> 
</head> 
<body> 
<?php 

incl ude( "connexpdo. inc.php" ) ; <— O 

if ($idcom=connexpdo( "magasin" , "myparam") ) <— © 

{ 

$requete="SELECT * FROM article ORDER BY catégorie" ; ^0 
$result=$idcom->query($requete) ; <— O 
if ( !$result) <-0 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) ,$mes_erreur[2] : <— © 

) 

else <— O 
{ 

$nbart=$resul t->rowCount( ) : <— © 

echo "<h3> Tous nos articles par catégorie</h3>" : 
echo "<h4> Il y a $nbart articles en magasin </h4>";<— © 
echo "<table border=\"l\">" ; 

echo "<tr><th>Code article</th> <th>Description</th> <th>Prix</th> 
^<th>Cat&#233:gorie</th></tr>" ; 
while($ligne=$result->fetch(PDO::FETCH_NUM)) ^© 
( 

echo "<tr>"; 

foreach($ligne as Svaleur) <— © 
{ 

echo "<td> Svaleur </td>"; 

} 

echo "</tr>"; 

) 

echo "</table>": 
} 

$resul t->cl oseCursor( ) : <— © 
$idcom=null ; <— © 

} 

?> 

</body> 
</html> 
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Figure 17-1 

Lecture de la table article 



Lecture des noms de colonnes. 

Dans l'exemple précédent, les titres des colonnes du tableau XHTML sont écrits à 
l'avance dans le script. Nous pouvons automatiser cette opération en récupérant les noms 
des colonnes de la table interrogée, ou les alias figurant dans les requêtes SQL, ce qui 
peut permettre la réalisation d'un affichage dynamique. 

Pour cela, nous allons lire les résultats dans un tableau associatif et récupérer les noms 
des colonnes de la table ou les alias éventuels, en récupérant les clés de ce tableau dans 
un autre tableau et en lui appliquant la fonction PHP array_keys( ) (voir le chapitre 5). 

L'exemple 17-5 illustre cette possibilité à partir d'une requête SQL sélectionnant les 
articles de la table article dont la désignation contient le mot « Sony », en définissant des 
alias pour les noms des colonnes (repère Q)- Après l'envoi de la requête par la méthode 
query( ), nous récupérons le résultat (repère 0) puis son nombre de lignes (repère 0). 
Nous utilisons ici la méthode f etchAl 1 ( ) pour récupérer toutes les lignes dans un unique 
tableau indicé Stabresul t (repère ©). Chacun des éléments de ce tableau est lui même un 
tableau associatif car nous avons passé la constante PDO: :FETCH_ASSOC en paramètre à la 
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méthode fetchAllO. Par exemple, le tableau $tabresult[0] contient les données de la 
première ligne du résultat ; il est associatif donc ses clés correspondent aux noms des 
colonnes ou alias précisés dans la requête SQL. Le tableau $titres, retourné par la fonc- 
tion array_keys() (repère©), ne contient donc que ces clés que nous lisons dans une 
boucle foreach pour afficher les en-têtes du tableau XHTML (repère ©). Deux boucles, 
for puis foreach (repères Q et 0), permettent la lecture du tableau multidimensionnel 
$tabresult pour l'affichage des données. Les objets connexion et résultat sont ensuite 
détruits (repères Q et ©)■ 

'■^ Exemple 17-5. Lecture automatique des noms des colonnes 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table arti cl e</titl e> 
<style type="text/css" > 

table {border-style:double:border-width: 3px;border-color: red; 

^background-color: yellow;} 

</style> 
</head> 
<body> 
<?php 

incl Lide( "connexpdo. inc.php" ) ; 
$idcom=connexpdo("magasin" ."myparam") ; 

// 

$requete="SELECT id_article AS 'Code article' .désignation AS 'Désignation' , prix 

^AS 'Prix Unitaire' .catégorie AS 'Catégorie' FROM article WHERE désignation 

^LIKE '^Sony^' ORDER BY categori e" ; <-© 

$result=$idcom->query($requete) ; <— 0 

if( !$result) 

{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) . $mes_erreur[2] ; 

} 

el se 
{ 

$nbart=$resul t->rowCount( ) : <— 0 

$tabresult=$result->fetchAll(PDO: :FETCH_ASSOC): 

//récupération des noms des colonnes ou des alias 

$titres=array_keys($tabresult[0] ) ; <— © 

//Affichage des titres de la page 

echo "<h3> Tous nos articles de la marque Sony</h3>": 

echo "<h4> Il y a $nbart articles en magasin </M>'; 

echo "<table border=\"l\"> <tr>''; 

//Affichage des titres du tableau 

foreach($titres as Snomcol ) <— 0 

{ 

echo "<th>". htmlentities($nomcol ) ."</th>''; 
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} 

echo "</tr>"; 

//Affichage des lignes de données 
for($i=0;$i<$nbart:$i++) <— © 
{ 

echo "<tr>"; 

foreach($tabresLilt[$i ] as $valeLir)<— 0 
{ 

echo "<td> Svaleur </td>"; 

} 

echo "</tr>": 

) 

echo "</table>"; 

} 

$resul t->cl oseCursorC ) ; <— © 

$idcom=null ; <— ® 

?> 

</body> 
</html> 

La figure 17-2 illustre les résultats obtenus. 
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Terminé 
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Récupération des valeurs dans un objet 

Les objets de type PDOStatement possèdent le méthode fetchObject( ), dont la syntaxe est : 
I object $result->fetchObject( ) 

À chaque appel de cette méthode, l'objet retourné représente une ligne de résultat et 
possède autant de propriétés qu'il existe d'attributs dans la requête SQL SELECT ; les noms 
de celles ci sont d'ailleurs ceux des colonnes de la table ou des alias éventuels. 



Si nous récupérons une ligne de résultat dans la variable : 

I $ligre=$result->fetchObject() 

La valeur d'un attribut nom est lue avec la syntaxe : 

I $ligne->noin 

L'exemple 17-6 réalise la recherche et l'affichage dans un tableau XHTML de tous les 
clients qui habitent Paris en utilisant cette méthode. En revanche, pour afficher les titres 
du tableau, nous n'allons pas utiliser la méthode développée dans l'exemple précédent. 
Dans la requête SQL, nous définissons des alias qui vont correspondre aux en-têtes 
(repère O). Pour les lire, nous appelons la méthode fetchObject( ) pour l'objet $result 
(repère©) et récupérons la première ligne de résultat dans la variable $ligne. Cette 
variable est un objet de type StdCl ass (la classe de base de PHP 5) dont les propriétés ont 
pour nom ceux des colonnes ou des alias de la requête. Comme il s'agit d'un objet, nous 
pouvons le parcourir au moyen d'une boucle foreach pour écrire les en-têtes du tableau 
XHTML (repère 0). Les valeurs associées ne nous intéressent pas encore ici. Pour récu- 
pérer le tableau des données nous utilisons une boucle do . . . whi 1 e (repère ©), ce qui nous 
permet de ne pas perdre les valeurs de la première ligne par un deuxième appel de la 
méthode fetchObject( ). Chaque nouvelle ligne est obtenue dans la condition de l'instruc- 
tion whi 1 e (repère 0). 

Exemple 17-6. Lecture des données dans un objet 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 
<title>Lecture de la table client</title> 
<style type="text/css" > 

table {border-style:double;border-width:3px; border-col or :red; 

^background-col or:yel low; } 

</style> 

</head> 

<body> 

<?php 

incl ude( "connexpdo. inc .php" ) ; 
$idcom=connexpdo( "magasin" . "myparam" ) ; 

$requete="SELECT id_client AS 'Code_client' , nom, prénom, adresse, âge, mail 
^FROM client WHERE ville ='Paris' ORDER BY nom":<-0 
$result=$idcom->query($ requête) ; 
if( !$result) 
{ 

$mes_erreur=$idcom->errorInfo( ) ; 

echo "Lecture impossible, code", $idcom->errorCode( ) , $mes_erreur[2] ; 

} 

el se 
{ 

$nbart=$resul t->rowCount( ) ; 
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$1 igne=$resul t->fetchObject( ) ; <— © 

echo "<h3> Il y a $nbart clients habitant Paris</h3>"; 

//Affichage des titres du tableau 

echo "<table border=\"l\"> <tr>"; 

foreach($ligne as $nomcol =>$val ) <— 0 

{ 

echo "<th>", SnoiTicol ,"</th>"; 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 
echo "<tr>"; 

//il faut utiliser do while car sinon on perd la première ligne de données 

do 

{ 

echo"<td>", $ligne->Code_client."</td>", "<td>", $1 igne->nom. "</td>" , "<td>" . 
^$1 igne->prenoin, "</td>" . "<td>" , $1 igne->adresse, "</td>" , "<td>" , $1 igne->age, 
^"</td>"."<td>". $ligne->mail , "</td></tr>" ; 

} 

while ($ligne = $result->fetchObject( ) ) ; 
echo "</table>"; 
$result->closeCursor( ) ; 
$idcom=nul 1 ; 

} 

?> 

</body> 
</html> 
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Il est également possible de récupérer des résultats dans un objet avec la méthode 
fetch( ), en utilisant la syntaxe suivante : 

I object $result->fetch(PDO: :FETCH_OBJ) 
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Par exemple, le code suivant permet d'afficher les résultats d'une requête SELECT : 

while($ligne=$result->fetch(PDO: :FETCH_OBJ)) 
{ 

foreach($l igne as $donnee) 
{ 

echo $donnee; 

) 

echo "<br />"; 

) 

Insertion de données dans la base 

Sur un site interactif, il faut pouvoir enregistrer dans la base de données les informations 
saisies par les visiteurs dans un formulaire XHTML, en vue d'une réutilisation ultérieure 
(par exemple, pour consulter ou réutiliser les coordonnées complètes d'un client). 

Comme dans les chapitres 15 et 16, placez-vous dans la perspective d'un site de e- 
commerce. Vous allez ainsi envisager la réalisation de la saisie puis de l'insertion des 
coordonnées d'un client dans la table cl i ent de la base magasin. Dans un second temps, 
vous lui permettrez de mettre à jour les informations enregistrées. 

Insertion des données 

Le formulaire XHTML est l'outil privilégié pour saisir des données et les envoyer vers le 
serveur PHP/MySQL. Nous disposons désormais de la fonction connexpdoO pour effec- 
tuer la connexion et des méthodes exec( ) et query( ) pour l'envoi des requêtes. Seule la 
commande SQL INSERT distingue cette opération de celle de lecture de données. Le script 
de l'exemple 17-7 réalise ce type d'insertion en récupérant les données saisies par le 
client dans un formulaire lors d'une commande. Nous commençons par vérifier l'exis- 
tence des saisies obligatoires correspondant aux variables $_POST['nom'], $_POST 
['adresse'] et $_POST['ville'] (repère O). Quand une requête est formée en utilisant les 
saisies faites par l'utilisateur, il est préférable d'utiliser le caractère d'échappement pour 
les caractères spéciaux des chaînes récupérées dans le tableau $_POST, en particulier les 
guillemets, qui peuvent poser problème dans la requête. Nous disposons pour cela de la 
méthode quote( ) des objets PDO dont la syntaxe est : 

I string $idcom->quote(string $chaine) 

La chaîne obtenue contient les caractères d'échappement "/" devant les caractères 
spéciaux NULL, \n, \r, ', " etControl-Z. 

Le script récupère toutes les saisies et les protège (repères Q à 0). La colonne i d_cl i ent 
de la table client ayant été déclarée avec l'option AUTO_INCREMENT, il faut y insérer la 
valeur NULL en lui donnant la valeur "\N" (repère 0). L'envoi de la requête se faisant avec 
la méthode execO, la valeur retournée est le nombre de lignes insérées (ici « 1 ») 
(repère Q), nous pouvons contrôler la bonne fin de l'insertion (repère ®). Le script doit 
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communiquer son identifiant au client pour qu'il puisse modifier éventuellement ses 
données. La valeur de la colonne id_client, qui a été déclarée AUTO_INCREMENT dans la 
table client, est récupérable à l'aide de la méthode 1 astlnsertldC ) de l'objet PDO. Ce 
nombre entier est affiché dans une boîte d'alerte JavaScript (repère ©). 

'•^ Exemple 17-7 Insertion de données 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>Saisissez vos coordonnées</title> 
</head> 
<body> 

<form action^ "<?php echo $_SERVER[ ' PHP_SELF' ] ;?>" method="post" 
enctype="appl i cation /x-www-form-url encoded"> 
<fieldset> 

<legend><b>Vos coordonnées</b></legend> 
<table> 

<tr><td>Nom : </td><td><input type="text" name="nom" size="40" maxl ength="30"/> 
^</td></tr> 

<tr><td>Prénom : </td><td><input type="text" name="prenom" size="40" 
^maxlength="30"/></td></tr> 

<tr><td>Age : </td><td><input type="text" name="age" size="40" maxl ength="2"/> 
^</td></tr> 

<tr><td>Adresse : </td><td><input type="text" name="adresse" size="40" 
*»maxlength="60"/></td></tr> 

<tr><td>Ville : </td><td><input type="text" name="ville" size="40" maxlength="40"/> 
*</td></tr> 

<tr><td>Mail : </td><td><input type="text" name="mail" size="40" maxl ength="50"/> 

^</td></tr> 

<tr> 

<td><inpijt type="reset" valLie=" Effacer "></td> 

<td><input type="submit" values" Envoyer "></td> 

</tr> 

</table> 

</fieldset> 

</form> 

<?php 

incl ude( "connexpdo. inc.php" ) ; 
$idcom=connexpdo( 'magasin' , 'myparam' ) ; 

if(!empty($_POST['nom'])&& !empty($_POST[' adresse '])&& !empty($_POST['ville'])) <-© 
{ 

Sid.client^'XN"; ^0 
$nom=$idcom->quote($_POST[ 'nom' ] ) ; <— © 
$prenom=$i dcom->quote( $_POST[ ' prénom ' ] ) ; <— O 
$age=$idcom->quote($_POST['age']) ; <— 0 
$adresse=$idcom->quote($_POST[ 'adresse' ]) ; <— © 
$ville=$idcom->quote($_POST['ville']) : <— Q 
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$mail=$iclcom->quote($_POST['niail ']); <— 0 

//Requête SQL 

$requete="INSERT INTO client 

VALUES ( Si d_client,$nom,$prenom, Sage, $adresse,$ville,$mail )"; 
^//pas de guillemets si on applique la méthode quote aux variables 
Snbl ignes=Sidcoiïi->exec( S requête) ; <— © 
if(Snblignes!=l) <-© 

{ 

Smess_erreur=Sidcom->errorInfo( ) ; 

echo "Insertion impossible, code", Sidcom->errorCode( ) , Smess_erreur[2] ; 

echo "<script type=\"text/javascri pt\"> 

al ert( ' Erreur : " .Sidcom->errorCode( ) . " ' )</script>" ; 

} 

el se 
{ 

echo "<script type=\"text/javascript\"> 

alerte 'Vous êtes enregistré Votre numéro de client est : ". 

^Sidcom->lastInsertId() ." ' )</script>"; <— © 
Sidcom^nul 1 ; 
} 

} 

else {echo "<h3>Formul ai re à compléter!</h3>" ; } 
?> 

</body> 
</html> 

La figure 17-4 illustre la page de saisie et la figure 17-5 la boîte d'alerte JavaScript qui 
donne son identifiant au client. 



P Saisissez vos coordonnées - Mozilia hretox 
£ifhiH Fditîon ^fïchxqe Hî^nnqii^ MMf^i^-yiAcje^ Oiitik ? 

» C *^ http://localhost/chapl7/mysqlpdQex7.php \j • jjGl'l Gooqjr" 

|— Vos coordonnées 

Nom : 
Prénom : 
Age : 
Adresse : 

Ville: ' 
Mal : 



Eflacer 



Envoyer [ 



Formulaire à compléter! 



Figure 17-4 

Formulaire d'insertion de données 
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Annonce de la page http://)ocalhost : 




Vous êtes enregistré Votre numéro de client est ; 51 




Figure 17-5 

Boîte d'alerte JavaScript donnant le numéro de client 



Mise à jour d'une table 



Un client doit pouvoir modifier ses coordonnées, son adresse de livraison ou son adresse 
mail par exemple. L'exemple 17-8 crée une page contenant un formulaire qui permet la 
saisie du code client dans une zone de texte XHTML (repère O). L'attribut action de 
l'élément <form> renvoie le traitement de la saisie au fichier mysqlpdoex9.php de l'exem- 
ple 17-9. La page créée est conforme à la figure 17-6. 

Exemple 17-8 Page de saisies des modifications 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Modifiez vos coordonnées</title> 



<body> 

<form action= "mysqlpdoex9.php" method="post" enctype= 

^"appl i cation /x-www-form-url encoded"> 

<fieldset> 

<legend><b>Saisissez votre code client pour modifier vos coordonnées</b></l egend> 

<table><tbody> 

<tr> 

<td>Code client : </td> 

<td><input type="text" name="code" size="20" maxl ength="10"/></td><— O 

</tr> 

<tr> 

<td>Modifier : </td> 

<td><input type="submit" val ue="Modifier"/></td> 
</tr> 

</tbody></table> 

</fieldset> 

</form> 



</head> 



</body> 
</html> 



La mise à jour des coordonnées du client est réalisée par le script de l'exemple 17-9. 
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, Modifiez vos coordonnées - Mozilla Firefox 



Fichier Édition Affichage Histoiique Marque-pages Outils ? 



- G ' I http://localho5t/chiipl7/my3qlpdoofi.php 

— Saisissez votre code client pour modifier vos coordonnées — 



[iCl'i Google 



Code L'IicuL : 
Modifier : Modifior 



Figure 17-6 

Page de saisie du code client 



La première inclusion de code PHP renvoie le client vers la page de saisie du code s'il a 
validé le formulaire sans avoir effectué de saisie (repère O)- Rappelons, comme nous 
l'avons déjà vu par ailleurs, que cette partie de code PHP doit figurer en tête du fichier 
car elle utilise la fonction header( ) pour effectuer la redirection. 

La suite du fichier comporte deux parties distinctes. La première crée dynamiquement un 
formulaire permettant la modification des données, quant à la seconde, elle enregistre ces 
mêmes données dans la base. 

Lors du premier appel du fichier de l'exemple 17-9, la condition de l'instruction if 
(repère©) est nécessairement vérifiée car la variable $_POST['modif' ] n'existe pas 
encore. Elle correspond à la valeur associée au bouton submit du formulaire qui n'est pas 
encore créé. Le script génère une connexion au serveur MySQL pour y lire les coordon- 
nées actuelles du client, dont le code est contenu dans la variable $code issue de la page 
de saisie de l'exemple 17-8 (repère 0). 

Dans le but de compléter le formulaire avec les données actuelles, la requête SQL sélec- 
tionne toutes les colonnes de la table client dont l'identifiant client (colonne i d_cl i ent de 
la table cl i ent) correspond à la valeur de la variable $code (repère Q). Cela permet de ne 
saisir que les modifications éventuelles de coordonnées du client, sans devoir ressaisir 
l'ensemble. Ces coordonnées sont lues à l'aide de la méthode fetch( ) de l'objet $result 
de type PDOStatement. Elles sont alors contenues dans la variable $coord de type array. 
Pour afficher les coordonnées dans le formulaire, vous devez attribuer les valeurs de ces 
éléments aux attributs value des différents champs <input /> (repère ©). 

La figure 17-7 montre un exemple de création dynamique de formulaire pour le client 
dont l'identifiant vaut 12. Le champ caché code du formulaire permet de passer la valeur 
du code client à la partie du script chargée de l'enregistrement des données modifiées 
(repère Q). 

L'envoi du formulaire utilise la deuxième partie du script, qui met à jour les données du 
visiteur dans la table client après avoir vérifié l'existence de valeurs pour les champs 
obligatoires du formulaire (repère©). Seules les colonnes nom, adresse, ville et mail 
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peuvent être mises à jour à l'aide de la requête suivante (repère Q), le reste étant forcé- 
ment inchangé : 

I UPDATE client SET noni='$nom' ,adresse='$adresse' ,ville='$ville' ,mail = '$niail ' 
WHERE id_client='$code' 

La vérification du résultat de la requête (repère ©) permet d'afficher une boîte d'alerte 
JavaScript contenant soit un message d'erreur, soit la confirmation de l'enregistrement. 
La page ne devant pas être une impasse, le visiteur est redirigé d'office vers la page 
d'accueil du site index. html (repères ® et ®). 

Exemple 1 7-9 Mise à jour des données 

<?php 

if (empty($_POST[ 'code' ] ) ) {header( "Location :mysql pdoexS.php" ) ; } <— O 

?> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Ll/ZEN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr''> 
<head> 

<meta http-equi v="Content-Type" content="text/html ; charset=iso-8859-r' /> 

<title>Modifiez vos coordonnées</title> 
</head> 
<body> 
<?php 

include( 'connexpdo.inc.php' ) ; 
$idcom=connexpdo( 'magasin' , 'myparam' ) ; 

if(!isset($_POST['modif'])) <-© 
{ 

$code={integer)$_POST[ ' code' ] ; <— 0 
//Requête SQL 

$requete="SELECT * FROM client WHERE id_client='$code' " ; <-© 
$resul t=$idcom->query($ requête) 
$coord=$resul t->f etch( PDO: : FETCH_NUM) ; <r-0 

//Création du formulaire complété avec les données exi stantes <— © 
echo "<form action= \"". $_SERVER['PHP_SELF']."\" méthode 
^\"post\"enctype=\"appl ication/x-www-form-urlencoded\">" ; 
echo "<fieldset>" : 

echo "<legend><b>Modifiez vos coordonnées</b></l egend>" ; 
echo "<table>"; 

echo "<tr><td>Nom : </td><td><input type=\"text\" name=\"nom\" 
^size=\"40\" maxlength=\"30\" val ue=\"$coord[l]\''/> </td></tr>": 
echo "<tr><td>Prénom : </td><td><input type=\"text\" name=\"prenom\" 
^size=\"40\" maxlength=\"30\" val ue=\"$coord[2]\"/></td></tr>" ; 
echo "<tr><td>Age : </td><td><input type=\"text\" name=\"age\" 
^size=\"40\" maxlength=\"2\" val ue=\"$coord[3]\"/></td></tr>" ; 
echo "<tr><td>Adresse : </td><td><input type=\"text\" name=\"adresse\" 
^size=\"40\" maxlength=\"60\" val ue=\"$coord[4]\"/></td></tr>" : 
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echo "<tr><td>Ville : </td><td><input type=\"text\" naine=\"ville\" 

^si2e=\"40\" maxlength=\"40\" val ue=\"$coord[5]\'7></td></tr>" ; 

echo "<tr><td>Mail : </td><td><input type=\"text\" name=\"inai 1 \" 

*size=\"40\" maxlength=\"50\" val ue=\"$coord[6]\"/></td></tr>" ; 

echo "<tr><td><input type=\"reset\" value=\" Effacer \"></td> <td> 

^<input type=\"submit\" naine=\"modif\" value=\"Enregistrer\"></td></tr></table>": 

echo "</fieldset>" ; 

echo "<input type=\"hidden\" name=\"code\" val ue=\"$code\"/>" ; <— © 

echo "</forin>"; 

$resul t->cl oseCursor( ) ; 

$idcom=nul 1 ; 

) 

elseif(isset($_POST['nom'])&& isset($_POST[' adresse '])&& 

^isset($_POST['ville'])) <-0 

{ 

//ENREGISTREMENT 

$noin=$idcoin->qLiote($_POST[ ' nom' ] ) ; 
$adresse=$idcom->quote($_POST[ 'adresse' ]) ; 
$ville=$idcom->quote($_POST[' ville']); 
$niail=$idcom->quote($_POST[ 'mail ' ]) ; 
$age=(integer)$_POST[ 'âge'] : 
$code=(integer)$_POST['code' ] ; 
//Requête SQL 

$requete=''LIPDATE client SET nom=$nom,adresse=$adresse,ville=$ville,mail=$inail , 
^age=$age WHERE id_cl ient=$code" ; ^0 
$result=$idcom->exec($requete) ; 

if($result!=l) <-® 

{ 

echo "<script type=\"text/javascript\"> 

alert( ' Erreur : " .$idcom->errorCode( ) . " ' )</script>" ; <— 0 

} 

el se 
{ 

echo "<script type=\"text/javascript\''> alertCVos modifications 

^sont enregistrées ' ) ;window.location=' index.html ' ;</scri pt>" ; <— ® 

} 

$idcom=null ; 

} 

el se 
{ 

echo "Modifier vos coordonnées!"; 

) 

?> 

</body> 
</html> 



510 



PHP 5 



, Modifiez vos coordonnées - Mozilla Fîrefox 



Rchier Édition /fichage Histonque Marque-pages Outils ? 

' c 



i ' http://localhost/chapl7/mysqlpdoeiâ.php "uT - 

Modifiez vos coordonnées 

Nom : 



|lGl'| CoogJc 



Prcnom : 
Age : 
Adresse : 
Vflle : 
Mail: 



Engels 

Jean 
5fi 



Rue compoint 



Paris 



php5@funhtml com 



Fffaner 1 1 Fnregislrer 



Figure 17-7 

Formulaire de saisie des coordonnées créé dynamiquement 



Recherche dans la base 

Un site de commerce en ligne doit permettre à ses visiteurs et futurs clients d'effectuer 
des recherches dans la base de données afin d'accéder plus rapidement à l'information 
correspondant au produit recherché. Il doit en outre permettre d'effectuer des statistiques 
marketing à l'usage du propriétaire du site. Ces éléments concernent aussi bien les sites 
de commerce en ligne que les annuaires et moteurs de recherche des sites de contenu. 

L'exemple 17-10 crée un formulaire classique permettant de saisir un mot-clé et de choi- 
sir le type de tri des résultats. Les critères de tri selon le prix, la catégorie ou l'identifiant 
d'article sont affichés sous forme de liste déroulante. Le choix de l'ordre croissant ou 
décroissant s'effectue au moyen de deux boutons radio possédant le même attribut name, 
ce qui les rend exclusifs l'un de l'autre. 

Le script contrôle d'abord que le visiteur a saisi un mot-clé dans le formulaire en véri- 
fiant que la variable $_POST['motcle'] n'est pas vide (repère Q)- H récupère ensuite le 
mot-clé, la catégorie, le critère de tri et l'ordre d'affichage respectivement dans les varia- 
bles $motcle, $categorie, $ordre et $tri (repères Q à 0). 

Si la catégorie choisie est "tous", la partie de la commande WHERE concernant cette catégo- 
rie est vide. Pour les autres choix, elle est égale à "AND categorie=$categorie" (repère ©). 
La requête de sélection suivante (repère est alors créée par le code : 

"SELECT id_article AS 'Code article', 
désignation AS 'Description', 
prix, catégorie AS 'Catégorie' 

FROM article WHERE lower(designation) LIKE'^Smotcle^'" .$reqcategorie. 
"ORDER BY $tri $ordre"; 
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On peut remarquer l'utilisation de la fonction MySQL 1 ower( ) qui permet d'effectuer une 
recherche insensible à la casse ; de cette façon, que l'utilisateur cherche les mots-clés 
« sony » ou « Sony », il obtiendra bien les résultats présents dans la table article. 

L'utilisation d'alias donne un meilleur affichage des titres du tableau de résultats. Après 
la connexion au serveur, vous récupérez le résultat de la requête dans la variable $ resuit. 
La lecture des résultats et l'affichage de toutes les lignes retournées sont réalisés avec la 
méthode fetch( ) de la même manière que dans les exemples précédents (repère 0). La 
figure 17-8 montre la page créée après la recherche du mot-clé portabl e. 

"•^ Exemple 17-10. Page de recherche d'articles 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=utf-8" /> 

<title>Rechercher un article dans le magasin</title> 
</head> 
<body> 

<form action= "<?php echo $_SERVER['PHP_SELF']?>" method="post" 

*enctype="appl ication/x-www-form-url encoded"> 

<fieldset> 

<1 egend><b>Rechercher un article en magasin</b></legend> 

<table> 

<tbody> 

<tr> <td>Mot-cl&#233:: </td> 

<td><input type="text" name="motcl e" size="40" maxlength="40" 

^value="<?php $_POST['motcle']?>"/></td> 

</tr> 

<tr> 

<td>Dans la cat&#233:gorie : </td> 
<td> 

<select name="categorie"> 

<option val ue=" tous" >Tous</option> 

<option val ue=" vidéo ">Vidéo</option> 

<option val ue="informatique">Informatique</option> 

<option val ue=" photo" >Photo</option> 

<option val ue= "divers ">Divers</option> 

</select> 

</td> 

</tr> 

<tr> 

<td>Trier par : </td> 
<td> 

<select name="tri"> 

<option val ue=" prix" >Prix</option> 

<option val ue="categorie">Catégorie</option> 

<option val ue="id_article">Code</option> 

</select> 



</td> 
</tr> 

<tr><td>En ordre: </td> 

<td>Croissant<input type="radio" name="ordre" value="ASC" checl<ed="checked"/> 
^Décroissant<input type="radio" name="ordre" value="DESC" /> 
</td> </tr> 

<tr><td>Envoyer</td><td><input type="submit" name="" val Lie="OK"/> </td> </tr> 
</tbody> 
</table> 
</fieldset> 
</form> 
<?php 

if(!empty($_POST['motcle'])) <— O 
{ 

include('connexpdo.inc.php'); 
$irotcle=strtolower($_POST['motcle']) ; <— 0 
$categorie=($_POST[ 'catégorie' ] ) ; <— 0 
$ordre=($_POST['ordre']); 
$tri = ($_POST['tri ']); 

//Requête SQL 

$reqcategorie=($_POST[ 'categorie']=="tous'' )?"" : "AND categorie= 
^ ' $categori e ' " ; <— 0 

$requete="SELECT id_article AS 'Code article' .désignation AS 'Description' .prix, 

^catégorie AS 'Catégorie' FROM article WHERE lower(deslgnation) 

^LIKE'%$motcle^"'.$reqcategorie.''ORDER BY $tri $ordre";<— Q 

$1dcom=connexpdo( 'magasin' .'myparam' ) : 

$resul t=$1dcoin->qLiery($ requête) ; <— 0 

if(!$result) <-0 

{ 

echo "Lecture Impossible"; 

} 

el se 
{ 

$nbcol=$result->col umnCount( ) ; 
$nbart=$result->rowCount( ) ; 
if ($nbart==0) 

{ 

echo "<h3> Il n'y a aucun article correspondant au mot-clé : Smotcle 

^</h3>": 

exit; 

} 

$11gne=$result->fetch(PD0::FETCH_ASS0C): //tableau associatif 
$t1tres=array_keys($11gne) ; 
$1 igne=array_val ues($l Igne) ; 
//pr1nt„r($titres) ; 

echo "<h3> Il y a $nbart articles correspondant au mot-cl&#233: : Smotcl e</h3>" 
//Affichage des titres du tableau 
echo "<table border=\"l\"> <tr>": 
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foreach($titres as $val) 
{ 

echo "<th>". htmlentities($val ) ,"</th>"; 

} 

echo "</tr>"; 

//Affichage des valeurs du tableau 

do 

{ 

echo "<tr>"; 

foreach($l igne as $donnees) 
{ 

echo "<td>" , $donnees , "</td>" ; 

} 

echo "</tr>"; 

) 

whi 1 e ( $1 i gne=$resul t->f etch (PDO : : FETCH_NUM) ) ; 

) 

echo "</table>": 
$resul t->cl oseCursor( ) ; 
$idcom=nul 1 ; 

} 

?> 

</body> 
</html> 



1^ RcUicrdici un ailiUc Jati^ le rna^jaMii - MuJila Fittrfux 



Fichier Édition Affichage Historique Marque-pages Outils ? 

C ^ { — i http://loc3lhost/chapl7/rnysqlpdoexl0.php ^ - | ||C|- 



Google 



Rechercher un article en magasin - 

Mot-clé: 



portabicl 



Dans la catégorie : Tous 

Trier par : Prix 

En ordre: Croissant ® Décroissant ( 

EuvovCT OK 



Dy a 3 articles correspondant au mot clé : portable 



Code article | Description 


prix 1 Catégorie ' 


DhlLiO |Portable Dell XJUO 


1 7 1 5 . OU 1 informatique: 


SAX15 |Portable Samsung X15 XVM 


1999.00 |informatique| 


SOXMP |PC Portable Sony Z 1 -XMP 


ii99.0U|informatique 



Figure 17-8 

Formulaire de recherche et résuhats obtenus 
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Les requêtes préparées 

Nous avions déjà construit dynamiquement des requêtes SQL dans l'exemple précédent 
à partir d'informations saisies par l'utilisateur. Les requêtes préparées permettent de 
créer des requêtes SQL qui ne sont pas directement utilisables mais qui contiennent des 
paramètres auxquels on peut donner des valeurs différentes en fonction des besoins, par 
exemple, pour des appels répétitifs avec des valeurs différentes. Une requête préparée se 
présente, entre autres, sous la forme suivante : 

I SELECT prénom. nom FROM client WHERE ville=? AND id_client>=? 

Dans laquelle les caractères ? vont être remplacés par des valeurs quelconques en fonc- 
tion des besoins du visiteur. C'est la méthode que nous avons employée au chapitre 16. 

Ou encore avec des paramètres nommés : 

I SELECT prénom. nom FROM client WHERTE ville=:ville AND icl_client=:id_client 
C'est d'ailleurs cette méthode que nous allons utiliser ici. 

Les paramètres nommés : vi 1 1 e et : i d„cl i ent, dont les noms sont ici les mêmes que ceux 
des attributs de la table cl ient, sont en fait arbitraires. 

La démarche à suivre pour utiliser une requête préparée est la suivante : 

1. Écrire la chaîne de requête comme paramètre de la méthode prepare( ) de l'objet PDO. 
Cette méthode retourne un objet de type PDOStatement qui représente la requête prépa- 
rée et qui est noté $reqprep dans notre exemple. 

2. Lier les paramètres dans l'ordre de leur apparition avec des valeurs ou des variables. 
Cette liaison peut se faire de plusieurs manières : 

- En créant un tableau associatif de la forme : 
$tab=array( ' :vi 1 le'=>$vil le. ■id_cl i ent ■=>$id_cl ient) 

les variables $vi 1 1 e et $i d_cl i ent ayant déjà des valeurs à ce stade. Ce tableau sera 
ensuite passé en paramètre à la méthode exécute ( ) détaillée ci-après. 

- En appelant la méthode bi ndParam( ) des objets PDOStatement pour chaque paramètre 
selon le modèle : 

bindParam( ' :ville' .$ville,PDO: :PARAM„STR) 

dans lequel le troisième paramètre désigne le type de la variable et peut prendre les 
valeurs PDO : : PARAM_STR pour une chaîne et PDO : : PARAM_I NT pour un entier. 

3. Exécuter la requête en appelant la méthode execute( ) de l'objet PDOStatement avec le 
tableau comme paramètre, s'il a été créé à l'étape 2, ou sinon sans paramètre. 

4. Pour les requêtes préparées qui retournent des résultats, comme celles qui contien- 
nent la commande SELECT, il faut ensuite lier les résultats à des variables PHP, avec la 
méthode bindCol umn( ) selon les modèles : 

$regprep->bindCol umnd . Sprenom) 



ou encore 



$regprep->bindCol umn ( prénom, $prenom) 

Dans ce cas, la valeur de la colonne 1 désignée dans la requête sera contenue dans la 
variable Sprenom, et ainsi de suite. 

5. Les lignes de résultats sont obtenues en appliquant une des méthodes vues précédem- 
ment, comme fetchO ou fetchAllO, à l'objet PDOStatement représentant la requête 
préparée, désignée ici par $regprep. Une ou plusieurs boucles, selon les cas, permet 
d'afficher les résultats en utilisant les variables créées à l'étape 4. 

6. Libérer la mémoire occupée par l'objet PDOStatement avec la méthode close- 
CursorC ). 

L'exemple 17-11 présente une application de requête préparée dans laquelle ce sont les 
saisies d'un utilisateur qui déterminent les valeurs des paramètres et donc la requête 
finale. Un formulaire classique demande la saisie d'un nom de ville et d'un numéro de 
client (repères Q st 0) dans le but de trouver tous les clients habitant cette ville et dont 
l'identifiant est supérieur ou égal à la valeur saisie. Ces informations sont tout d'abord 
récupérées dans les variables $vi 1 1 e et $i d_cl i ent (repères Q et Q). Après la connexion 
à la base, nous écrivons la requête préparée avec la méthode prepareO (repère 0). La 
liaison des paramètres aux variables $ville et $icl_client est effectuée en appelant la 
méthode bindParam( ) avec les arguments qui précisent le type de variables (repères Q 
et O). La requête est ensuite exécutée avec la méthode executeO sans paramètre 
(repère 0). Les résultats des colonnes prénom et nom de la table client sont ensuite liés 
aux variables Sprenom et $nom (repères Q et ®). Une boucle while parcourt l'ensemble 
des résultats et permet l'affichage de toutes les lignes (repère 0). 

Notez que, comme nous le venons de le voir en exposant la méthode générale, pour obtenir 
un résultat identique, les trois lignes de liaison des paramètres pourraient être remplacées 
par les lignes suivantes : 

I//*****Liaison des paramètres 
$reqprep->execute(array( ' :ville' => Sville, ':id_client' $id_cl ient) ) ; 

Exemple 17-11 Utilisation des requêtes préparées 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset=iso-8859-r' /> 
<title>Recherche de client</title> 
<style type="text/css" > 

div{font-size: 20px;} 
</style> 
</head> 
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<body> 

<form method="post" action="<?php echo $_SERVER['PHP_SELF'] ;?>"> 

<fieldset> 
<legend>Recherche de client</legend> 

<label>Ville </label><input type="text" name="ville" /Xbr /Xbr /><— Q 
<label>Id_client</label><input type="text" name="id_cl ient" /Xbr /><— © 
<input type="submit" val ue="Envoyer" /> 
</fieldset> 

</forin> 

</body> 

</html> 

<?php 

if(isset($_POST['ville']) && isset($_POST['id_client'])) 
{ 

$ville=strtolower($_POST['vine']) ; <-0 
$i d_cl i ent=$_POST[ 'i d_cl i ent' ] ; <-© 
include('connexpdo.inc.php'); 
$idcom=connexpdo( 'magasin' ,'myparam' ) ; 

$reqprep=$idcoin->prepare( "SELECT prénom, nom FROM client WHERE 
^lower(ville)= :ville AND id_client>= :id_client ");<—© 
//*****Li ai son des paramètres 

$reqprep->bindParam( ' :ville' ,$vil le.PDO: :PARAM_STR) ; <— © 
$reqprep->bindParam( ' :id_client' ,$id_client,PDO: :PARAM_INT); <— O 
$reqprep->execute( ) : <— 0 

//*****Li ai son des résultats à des variables 
$reqprep->bindCol umn( ' prénom' , $prenom) ; <— © 
$reqprep->bindCol umn( ' nom' , $nom) ; <— © 

//*****Affichage 

echo "<div><h3>Il y a ", $reqprep->rowCoLint( ) ," client(s) habitant à ", 

^ucf i rst($vi 1 le) , " et dont l'identifiant est supérieur à $id_cl ient</h3><hr />"; 

while($result=$reqprep->fetch(PDO: :FETCH_BOUND)) <-© 

{ 

echo "<h3> $prenom $nom</h3>"; 

) 

echo "</div>"; 
$reqprep->cl oseCursor( ) ; 
$idcom=nul 1 ; 

} 

?> 

Avec notre base de données magasin et les paramètres "Paris" et "3" nous obtenons par 
exemple l'affichage présenté à la figure 17-9. 
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Figure 17-9 

Résultats d'une requête préparée 



Les transactions 

Dans l'exemple de notre base magasin, si un client effectue un achat, il faut réaliser 
simultanément deux insertions, une dans la table commande et une dans la table ligne. Si 
pour une raison quelconque, matérielle ou logicielle, la seconde insertion n'est pas réali- 
sée, alors que la première l' est déjà, la base contiendra une incohérence car il existera une 
commande ne comportant aucune ligne. L'inverse ne serait guère préférable puisqu'il 
existerait une ligne qui ne serait reliée à aucune commande. Les transactions permettent 
de gérer ce genre de situation en effectuant des commandes « tout ou rien » ce qui, en 
pratique pour notre exemple ci-dessus, permet d'exécuter les deux requêtes ou bien aucune 
si l'une des deux insertion n'a pas été effectuée. L'intégrité de la base est ainsi préservée. 

Le langage SQL possède des commandes qui permettent de gérer les transactions, mais 
PDO nous fournit des méthodes qui permettent de gérer les transactions sans y faire appel. 

Une transaction doit commencer par l'appel de la méthode begi nTransacti on( ) de l'objet 
PDO qui désactive le mode autocommit qui est automatiquement activé par défaut dans 
MySQL. L'envoi des requêtes au serveur se fait comme d'habitude avec les méthodes 
query( ) ou exec( ), selon qu'elles retournent des résultats ou pas. Ce n'est qu'après avoir 
vérifié que les différentes requêtes ont été correctement effectuées que nous pouvons 
valider l'ensemble en appelant la méthode commi t ( ) . Dans le cas contraire, par exemple si 
l'une d'entre elles n'a pas été réalisée, nous annulons l'ensemble en appelant la méthode 
rollBackO. 
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Dans l'exemple 17-12, nous illustrons la procédure à suivre pour effectuer deux 
commandes INSERT sur la table article (repères O et ©). Nous envoyons ensuite ces 
requêtes au serveur avec la méthode exec( ) qui retourne le nombre de lignes affectées par 
chaque requête. La variable $verif cumule donc le nombre total d'insertions (repères Q 
et 0). Si ce nombre vaut 2 (repère 0), nous pouvons valider la transaction avec la méthode 
commitO (repère©), sinon elle est annulée avec la méthode rollBackO (repère©), un 
message d'erreur est affiché (repères @ et 0) et le tableau indicé retourné par la méthode 
errorinf o( ) contenant le code d'erreur pour l'indice 0 et le message d'erreur en clair pour 
l'indice 2. Pour tester l'efficacité du script, il suffit d'introduire une erreur dans la 
seconde requête en écrivant, par exemple, le nom de table inexistant "cl i ents" à la place 
de "cl ient", pour constater avec phpMyAdmin qu'aucune insertion n'est effectuée alors 
que la première est valable. 

Exemple 17-12 Insertions avec transaction 

<?php 

incl ude( ' connexpdo. inc.php' ) ; 
$idcoin=connexpdo( 'magasin' .'myparam' ) ; 
$idcoin->beginTransaction( ) ; 
echo "<hr />"; 

$reqLietel=" INSERT INTO client(id_cl ient, nom, prénom, âge, adresse, vil le, mail ) 
^VALUES (NULL , 'Spencer', 'Marc', '32', 'rue du blues', 'Orléans', 
^ 'marc@spencer.be '):" ; <— 0 
echo Srequetel , "<hr />"; 

$requete2=" INSERT INTO client(id_cl ient, nom, prénom, âge, adresse, vil le,mail ) 
^VALUES (NULL , 'Spancer', 'Diss', '89', 'rue du Métad', 'New York', 
^'diss@metad.fr' );": <— 0 
echo $requete2, "<hr />"; 

//Insertions des données 

$verif= $idcom->exec($requetel) : <— 0 

$verif+= $idcom->exec($requete2) : <— 0 

if($verif==2 ) <-0 

{ 

$idcom->commit( ) : <— 0 

echo "Insertions réussies de $verif lignes<br />"; 

} 

el se 
{ 

$idcom->rollBack(); <— 0 
$tab_erreur=$idcom->errorInfo( ) ; 

echo "Insertions annulées. Erreur n' : " ,$tab_erreur[0] , "<br />";<— 0 
echo "Info : " , $tab_erreur[2] ; <— 0 

} 

?> 
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Mémo des méthodes 
Classe PDO 

boolean beginTransaction ( void ) 

Commence une transaction et retourne TRUE en cas de réussite ou FALSE sinon, 
boolean commit ( void ) 
Valide une transaction. 

objetPDO construct ( string $dsr [, string Susername [, string $password ]] ) 

Constructeur de la classe PDO. Crée un objet représentant la connexion, 
string errorCode ( void ) 
Retourne un code d'erreur, 
array errorinfo ( void ) 

Retourne un tableau contenant un code d'erreur (indice 0) et un message d'erreur (indice 2). 
integer exec ( string $requete ) 

Exécute une requête qui ne retourne pas de résultat et retourne le nombre de lignes affectées, 
string lastinsertid ( ) 

Retourne l'identifiant de la colonne dont l'attribut est déclaré AUTO_INCREMENT. 

objet PDOStatement prépare ( string $requete ) 

Crée une requête préparée et retourne un objet PDOStatement. 

objet PDOStatement query ( string $requete ) 

Envoie une requête au serveur et retourne un objet résultat. 

string quoteC string $ctiaine ) 

Protège les caractères spéciaux d'une ctiaîne. 

boolean rollBack ( void ) 

Annule la transaction courante. 

Classe PDOStatement 

boolean bindColumn ( divers $colonne, divers $var [. integer type] ) 

Lie une colonne désignée par son numéro ou son nom à une variable ; le type peut être PDO: :PARAM_STR pour une 
chaîne ou PDO: : PARAM_INT pour un nombre. 

boolean bindParam (divers $parametre, divers $variable [, int type ] ) 

Lie un paramètre nommé ou interrogatif à une variable. La constante type prend les mêmes valeurs que ci-dessus, 
integer columnCcunt ( void ) 
Retourne le nombre de lignes d'un résultat, 
string errorCode ( void ) 
Retourne un code d'erreur. 
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array errorinfo ( void ) 

Retourne un tableau contenant les informations sur l'erreur en cours, 
bool exécute ( [array $paranietre] ) 

Exécute une requête préparée ; le paramètre peut contenir les liaisons des paramètres nommés ou Interrogatifs. 
divers fetch ( [integer $style] ) 

Retourne une ligne de résultat sous forme de tableau Indicé ou associatif, 
array fetchAll ( [integer $style ) 

Retourne l'ensemble des lignes de résultat sous forme de tableau multidimensionnel indicé ou associatif, 
int rowCount ( void ) 

Retourne le nombre de lignes affectées par la dernière requête. 

Classe PDOException 

objet PDOException _construct() 
Crée un objet exception, 
string getCodeO 
Retourne le code d'erreur, 
string getFileO 

Retourne le nom du fichier dans lequel s'est produite l'erreur, 
integer getLineO 

Retourne le numéro de ligne du script où s'est produite l'erreur, 
string getMessage( ) 
Retourne le message d'erreur. 

Exercices 

Tous les exercices ci-dessous portent sur la base de données voitures créée aux chapi- 
tres 13 et 14. Ils sont identiques à ceux du chapitre 15 et 16 mais vous devez les réaliser 
uniquement avec PDO. 

Exercice 1 

Créez un script permettant d'afficher le contenu de la table modèle dans un tableau 
XHTML. Les résultats doivent être triés par marque. 

Exercice 2 

Créez un formulaire permettant l'insertion de nouvelles données dans la table mode! e. 
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Exercice 3 

Créez un formulaire permettant l'insertion simultanée des coordonnées d'une personne 
dans les tables propriétaire et cartegrise. Il doit contenir les zones de saisie des coor- 
données de la personne et la liste des modèles d'une marque créée dynamiquement à 
partir de la saisie de la marque. 

Exercice 4 

Créez un formulaire de recherche permettant de retrouver tous les propriétaires d'un type 
de véhicule de marque et de modèle donnés. Affichez les résultats sous forme de tableau 
XHTML. 

Exercice 5 

Créez un formulaire de recherche permettant de retrouver tous les véhicules possédés par 
une personne donnée. Affichez les résultats sous forme de tableau XHTML. 

Exercice 6 

Réécrivez entièrement le code de l'exercice 5 en récupérant tous les résultats dans des 
objets et en manipulant leurs propriétés. 

Exercice 7 

Refaire l'exercice 4 en utilisant une requête préparée. 
Exercice 8 

Refaire l'exercice 3 en utilisant une transaction pour s'assurer que les données sont bien 
insérées dans les différentes tables. 
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SQLite constitue l'une des grandes nouveautés de PHP 5. Il s'agit d'une base de données 
relativement puissante mais qui, à la différence de MySQL ou de PostgreSQL, ne néces- 
site pas l'installation d'un serveur de base de données en plus d'un serveur PHP car elle 
est incorporée à PHP comme l'est le module standard. 

D'après ses concepteurs et les tests réalisés, SQLite se révèle beaucoup plus rapide que 
MySQL et PostgreSQL pour les opérations de lecture. Les opérations d'écriture perdent 
un peu de cet avantage car dans ce cas la base est verrouillée dans son intégralité, même 
si l'opération ne concerne qu'une table. 

Dans l'état actuel de son développement, SQLite n'est intéressant que pour les applica- 
tions qui ne nécessitent pas un grand nombre d'accès concurrents en écriture à la base. Il 
y a peu de chance, par exemple, qu'un site comme Google l'adopte, mais elle pourrait 
suffire à des entreprises de taille moyenne et pour des applications installées sur des 
terminaux mobiles. 

Caractéristiques générales 

Contrairement à de nombreux autres SGBD, comme MySQL, SQLite crée la base direc- 
tement sur le disque dur de votre serveur. A chaque base correspond donc un seul fichier, 
quel que soit le nombre de tables qu'elle contient. Dans ce fichier sont à la fois enregis- 
trées la structure des tables et les données (voir figure 18-1). Comme vous le voyez, ce 
fichier est inutilisable tel quel. Pour cette raison, la modification de la structure d'une 
table est impossible en utilisant la commande ALTER TABLE. Vous devez d'abord sauvegar- 
der les données, effacer la table puis la recréer avec une nouvelle structure. 
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C sportifs - Bloc-notes 



Fichier Edition Format Affichage 
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Figure 18-1 

Structure d'un fichier de base SQLite 



SQLite supporte l'essentiel des fonctionnalités du langage SQL, à l'exception des 
suivantes : 

FOREIGN KEY ; 

Support complet de ALTER TABLE ; 
support intégral des triggers ; 
transactions imbriquées ; 
COUNT (DISTINCT X) ; 
VIEW en écriture ; 

GRANT et REVOKE (pas de gestion des droits d'accès). 

D'après les tests publiés sur le site SQLite (http://www.sqlite.org), cette base est jusqu'à trois 
fois plus rapide que MySQL dans les accès en lecture de données. En revanche, le fait 
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que toute la base soit contenue dans un seul fichier entraîne son verrouillage total lors des 
accès en écriture. Cela ralentit les opérations dans le cas d'accès concourants à la base. 

Dans sa version actuelle 2.8, SQLite est dite « typeless », c'est-à-dire qu'elle n'oblige 
pas à effectuer une déclaration du type de chaque colonne lors de la création des tables, 
contrairement à MySQL. Vous pouvez cependant conserver vos habitudes pour l'écriture 
des requêtes SQL de création des tables en définissant un type pour chaque colonne. 

Lors des opérations de comparaison et de tri, SQLite établit une différence entre les 
valeurs numériques et les textes. Les colonnes déclarées avec un type contenant les mots 
CHAR, TEXT OU BLOB sont considérées comme du texte. Toutes les autres possibilités, y 
compris les types personnels non normalisés par le SQL, sont considérées comme numé- 
riques. 

Dans le code suivant : 

I CREATE TABLE matable(nom LETEXTE. âge SONAGE) 

La colonne nom est considérée comme du texte et la colonne âge comme un nombre en 
32 bits. 

Ce typage des données étant peu rigoureux pour une base de données, la version 3.0 de 
SQLite prévoit de reconnaître explicitement les types suivants : NULL, INTEGER, REAL, TEXT 
et BLOB, ce qui la rapprochera des pratiques habituelles. Dans la suite du chapitre, vous 
créerez les tables de votre base en déclarant le type des colonnes. 

De nombreuses tables comportent une clé primaire, qui est un entier auto-incrémenté 
d'une unité à chaque nouvelle insertion. SQLite ne reconnaît pas l'attribut AUTO_INCREMENT 
utilisé avec MySQL pour créer ce type de colonne. Pour obtenir le même résultat, il faut 
déclarer la colonne avec le type INTEGER PRIMARY KEY, comme ci-dessous : 

I CREATE TABLE personnedd INTEGER PRIMARY KEY. nom VARCHAR(20) ); 

L'insertion de la valeur NULL dans la colonne id permet cette incrémentation automa- 
tique. 



Linterface SQLiteManager 

Comme pour MySQL avec phpMyAdmin, des programmeurs bénévoles ont créé des 
interfaces de gestion en ligne des bases de données SQLite. Il en existe plusieurs, comme 
phpSQLiteAdmin et SQLiteManager. Cette dernière version est livrée d'office avec 
Wampserver. 

Si votre hébergeur n'offre pas cette interface, vous pouvez l'installer vous même 
puisqu'il s'agit de fichiers PHP (voir le site http://www.sqlltemanager.org). La figure 18-2 
montre la page d'accueil de SQLiteManager 1.2, à partir de laquelle vous pouvez créer 
une base et les tables qui la composent. L'application sur laquelle reposent les exemples 
de ce chapitre a pour but de créer un site de contact entre sportifs partageant la même 
passion et leur permettant de trouver des partenaires éventuels. Ce modèle pourrait être 
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facilement transposé à d'autres applications pratiques. Vous aurez à développer entière- 
ment cette application au chapitre 21. 
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Figure 18-2 

La page d'accueil de SQLiteManager 



Le modèle conceptuel de données (MCD) de la base nommée sportifs est illustré à la 
figure 18-3. Il comporte les contraintes suivantes : 

• L'entité personne regroupe les données personnelles d'un visiteur inscrit. 

• L'entité sport contient les caractéristiques de chaque sport. 

• L'association pratique relie ces deux entités. 

• Une personne pratique un ou plusieurs sports. La cardinalité du côté de l'entité 
personne est donc 1:N. 

• Un sport est pratiqué par une ou plusieurs personnes. La cardinalité du côté de l'entité 
sport est donc 1:N. 



personne 

idpersonne 

nom 

prénom 

départ 

mail 



Figure 18-3 

Le MCD de la base sportifs 
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Le modèle logique de données (MLD) correspondant, en application des règles vues au 
chapitre 13, est représenté à la figure 18-4. Chaque personne peut pratiquer de 1 à W 
sports, et un sport peut être pratiqué par 1 à personnes. 



personne 


► 


pratique 


id personne 


id personne 
id sDort 
niveau 


nom 
pronom 
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mail 





Figure 18-4 

Le MLD de la base sportifs 




La base sportifs comprend donc les trois tables suivantes : 

• La table personne, qui contient les coordonnées de chaque personne inscrite sur le site 
(nom, prénom, département, adresse e-mail). L'identifiant auto-incrémenté idjersonne 
est la clé primaire de la table. 

• La table sport, qui contient le nom de chaque sport pratiqué contenu dans l'attribut 
desi gn. Elle sera enrichie par les visiteurs du site en fonction de leurs besoins. Chaque 
sport a un identifiant unique auto-incrémenté id_sport, qui est la clé primaire de la 
table. 

• La table pratique est la représentation de l'association entre les tables personne et 
sport. Sa clé primaire est constituée des clés primaires des tables personne et sport. On 
obtient ainsi l'association entre une personne et un sport. L'attribut niveau contient le 
niveau de pratique de chaque utilisateur pour un sport donné. 

Pour créer les tables, vous utilisez SQLiteManager. Pour cela, dans la page d'accueil de 
Wampserver (http://1 27.0.0.1 ou http://localhost) ou dans le menu de Wamp2, cliquez sur 
SQLiteManager afin d'obtenir la page représenté à la figure 18-2. 

Pour que les bases soient manipulables avec SQLiteManager, il faut qu'elles soient 
créées dans le répertoire C:/wamp/apps/sqlitemanagerl.2.0/. Complétez les zones de 
saisies conformément à la figure 18-2, puis cliquez sur Enregistrer. Un fichier nommé 
sportifs est alors créé sur le serveur. La création des tables se déroule ensuite selon la 
même démarche qu'avec phpMyAdmin. Il faut d'abord saisir le nom de la table et son 
nombre de colonnes, puis une nouvelle page permet la définition des caractéristiques de 
chaque colonne. 



Méthodes d'accès à SQLite 

L'accès à une base SQLite peut être fait de deux manières différentes : 

• La méthode procédurale classique, qui emploie des fonctions PHP, comme nous 
l'avons réalisé avec MySQL. Pour un rôle identique, les noms des fonctions sont 
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souvent similaires à ceux de l'extension MySQL. Par exemple, au lieu d'avoir la fonc- 
tion mysql_query( ) on aura la fonction sql ite_query( ). 

• La méthode objet, qui emploie quatre types d'objets différents ayant chacun des 
propriétés et des méthodes qui permettent l'accès aux données. Cette méthode se situe 
davantage dans l'esprit de PHP 5, plus orienté objet que les versions précédentes. 

Vous allez réaliser de mêmes exemples selon ces deux méthodes. 

La méthode procédurale 

Quelles que soient les opérations que l'on désire réaliser sur la base SQLite, la méthode 
procédurale est presque semblable à celle utilisée pour MySQL. Elle consiste à suivre les 
étapes suivantes : 

1. Ouverture de la base, qui s'apparente plutôt à une ouverture de fichier. 

2. Envoi des requêtes SQL à effectuer sur la base. 

3. Récupération de la valeur de retour de la fonction de requête, qui est soit une valeur 
booléenne pour contrôler que la requête est bien exécutée — par exemple, CREATE 
TABLE, INSERT, UPDATE — , soit une valeur de type resource quand la requête SQL 
retourne des données — par exemple, SELECT. 

4. Utilisation le cas échéant des fonctions spécialisées de récupération des résultats, et 
création d'un affichage dynamique approprié avec PHP et XHTML. 

5. Fermeture de la base. 

Ouverture de la base 

Pour ouvrir une base SQLite, vous utilisez la fonction sql i te_open ( ) , dont la syntaxe est 
la suivante : 

^ resource sqlite_open (string nom_base [, integer mode [, string $erreur]]) 

Si la base n'existe pas, elle est créée. Vous devez indiquer obligatoirement le nom de la 
base comme premier paramètre. Celui-ci peut contenir le chemin d'accès complet au 
fichier ou une URL. Le paramètre mode est un nombre en octal, qui indique le mode 
d'ouverture du fichier (lecture ou écriture ou les deux, ainsi que les droits d'accès). Dans 
la version actuelle il n'est pas pris en considération, et sa valeur par défaut est 0666. 

La chaîne $erreur contient le nom de la variable qui sera affectée par référence avec le 
message d'erreur généré si l'ouverture de la base échoue. Vous pouvez donc afficher ce 
message le cas échéant. Dans ce cas, la fonction retourne la valeur FALSE, ce qui permet 
de contrôler le bon déroulement de l'opération. Si tout se passe correctement, la fonction 
retourne une variable de type resource, qui est un identifiant d'ouverture que nous récu- 
pérons dans la variable $id_base et qui est utilisé dans de nombreuses autres fonctions de 
la même manière qu'avec MySQL. 
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Nous aurons, par exemple, le code d'ouverture suivant : 
<?php 

if ($id_base = sqlite_open ("ina_base", 0666, Serreur)) echo "OK" ; 

else echo Serreur ; 

?> 

Si le premier paramètre est la chaîne " :memory : ", la base est créée dans la mémoire vive 
du serveur. Cette possibilité permet d'effectuer des traitements provisoires. La base créée 
est effacée à la fin du script. 

Il est également possible de réaliser une connexion persistante à l'aide de la variante 
sql ite_popen( ), dont la syntaxe est similaire : 

I resource sqlite_open (string nom_base [, integer mode [, string Serreur]]) 

Pour fermer la base, vous devez appeler la fonction sql ite_close( ), dont la syntaxe est la 
suivante : 

I void sqlite_close(resDurce $id_base) 

et dont le seul paramètre est l'identifiant d'ouverture de la base $i d_base. L'appel de cette 
fonction doit être fait le plus vite possible dans le script afin de libérer le fichier contenant 
la base qui est verrouillée en écriture à chaque accès. 



Envoi de requêtes 

L'étape suivante consiste principalement dans l'envoi à la base de requêtes écrites à 
l'aide du langage SQL. Les connaissances acquises au chapitre 14 vont vous permettre 
d'être tout de suite opérationnel. Vous n'utiliserez que certaines possibilités supplémen- 
taires qu'offre SQLite par rapport à MySQL. 

Pour envoyer une requête à la base, vous utiliserez le plus souvent la fonction sqlite_ 
query( ), dont la syntaxe est la suivante : 

I resource sqlite_query (resource $id_base, string Srequete) 

La variable $id_base est l'identifiant d'ouverture de la base et Irequete la chaîne conte- 
nant la ou les commandes SQL appropriées. 

Cette fonction retourne une variable de type resource si la requête SQL retourne des 
lignes de données, cette variable étant utilisable pour lire l'ensemble des données à l'aide 
de fonctions spécialisées, comme c'est le cas pour MySQL. Si la requête ne concerne pas 
une commande SQL fournissant des données, la fonction retourne une valeur booléenne 
TRUE si l'opération est réussie et FALSE dans le cas contraire. De plus, si la requête n'est 
pas exécutée, la fonction retourne encore FALSE, ce qui permet de vérifier sa bonne exécu- 
tion à l'aide d'une instruction if. 

Un script d'interrogation de la base a une structure identique à celle de l'exemple 18-1. 
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'•^ Exemple 18-1. Envoi de requête SQL 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqlitemanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

Srequete = "SELECT * FROM personne" ; 

if ($result = sqlite_query ($id_base, $requete)) 

{ 

echo "Requête effectuée <br />" ; 
//Lecture des résultats 

} 

else echo " La requête n'a pas aboutie" ; 

} 

else echo Serreur ; 
?> 

Pour que le résultat ne soit pas mis en buffer sur le serveur avant son utilisation par les 
fonctions de lecture, vous pouvez utiliser la fonction sql ite_unbuffered_query( ), dont la 
syntaxe est la suivante : 

I resource sql ite_unbuffered_query(resource $1d_base,string Srequete) 

Elle utilise les mêmes paramètres que la précédente. Si elle mobilise moins de mémoire 
sur le serveur, elle présente cependant l'inconvénient d'obliger à utiliser les données du 
résultat avant tout autre envoi de requête, faute de quoi les résultats sont perdus. 

Pour envoyer une requête qui ne retourne pas de résultats, par exemple, une requête de 
création de table, d'insertion ou de mise à jour, il peut être plus efficace d'utiliser la fonc- 
tion sql ite_exec( ), dont la syntaxe est la suivante : 

1 boolean sql1te_exec(resource $1d_base.str1ng $requete) 

Elle exécute la requête $requete sur la base identifiée par $id_base et retourne TRUE si la 
requête est bien réalisée et FALSE dans le cas contraire. L'interface SQLiteManager 
n'étant pas encore exempte de bogues, il peut être plus sécurisant de créer les tables de la 
base sportifs à l'aide d'un script à n'exécuter qu'une seule fois afin d'éviter tout risque 
d'erreur, car la clause IF NOT EXISTS de MySQL n'existe pas dans SQLite. L'exemple 18- 

2 crée les tables de la base sporti f s en envoyant les requêtes SQL à la base avec la fonc- 
tion sql ite_exec( ) (repères 0> 0 ^t 0). 

Exemple 18-2. Création de table à l'aide d'un script 

<?php 

if ($id_base = sql i te_open( ' C: /wamp2/apps/sql i temanagerl .2.0/sportif stest ' , 0666, 

*»$erreur) ) 

{ 

echo "La base sportifs est ouverte"; 

//Création de la table personne 
$req_personne="CREATE TABLE personne ( 
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id_personne INTEGER PRIMARY KEY . 
nom VARCHARC 20 ) NOT NULL , 
prénom VARCHAR( 20 ) , 
départ INTEGER( 2) NOT NULL. 
mail VARCHAR(50) NOT NULL)"; 

if( sql ite_exec($id_base,$req_personne) ) echo "La table personne 
^est créée" ; <— O 

//création de la table sport 
$req_sport="CREATE TABLE sport ( 
id_sport INTEGER PRIMARY KEY . 
design VARCHAR( 30 ) UNIQUE NOT NULL)"; 

//CREATE UNIQUE INDEX sport„design ON sport(design) ; 

if (sql ite_exec($id_base,$req_sport) )echo "La table sport est créée"; <—© 

//création de la table pratique 
$req_pratique="CREATE TABLE pratique ( 
id_personne INTEGER NOT NULL. 
id_sport INTEGER NOT NULL . 
niveau TINYINT. 

PRIMARY KEY ( id_personne . i d_sport ) ) ; 

CREATE INDEX cle ON prati que( id_personne, id_sport ) ; " ; 

if( sql ite_exec($id_base.$req_pratique) ) echo "La table pratique 

^est créée" ; <— © 

sqlite_close($id_base) ; 

} 

el se 
{ 

echo "ERREUR : Serreur"; 

} 

?> 



Gestion des erreurs 

Les fonctions suivantes : 

int sqlite_last_error ( resource $id_base) 
string sql ite_error_string ( int code_erreur) 

retournent respectivement le code et le message de l'erreur qui a été générée. 



Contrairement à MySQL, SQLite accepte les requêtes multiples. Il est donc possible de 
simplifier le code de l'exemple 18-2 en écrivant les différentes commandes SQL de créa- 
tion des trois tables dans une seule chaîne et en les séparant par des points-virgules, 
comme dans l'exemple 18-3. Après l'écriture de la requête multiple par concaténation de 
commandes SQL dans la chaîne $req_tabl es (repères 0> 0 st ©), l'envoi de celle-ci est 
réalisé par la fonction sql ite_exec( ) (repère ©). 
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'•^ Exemple 18-3. Les requêtes multiples 

<?php 

if ($id_base = sqlite_open ( "C: /wamp2/apps/sq1 itemanagerl .2.0/sporti f s" , 0666, 

^$erreur) ) 

{ 

echo "La base sportifs est ouverte": 
//Requête de création des tables 
$req_tables="CREATE TABLE personne ( 
id_personne INTEGER PRIMARY KEY . 
nom VARCHARC 20 ) NOT NULL , 
prénom VARCHARC 20 ) , 
départ INTEGERC 2) NOT NULL. 
mail VARCHAR(50) NOT NULL):";<-0 

$req_tables.="CREATE TABLE sport ( 

id_sport INTEGER PRIMARY KEY , 

design VARCHARC 30 ) UNIQUE NOT NULL); 

CREATE UNIQUE INDEX sport_design ON sport(design) ; " ; <-© 

$req_tables.="CREATE TABLE pratique ( 
id_personne INTEGER NOT NULL. 
id_sport INTEGER NOT NULL . 
niveau TINYINT. 

PRIMARY KEY ( id_personne , id_sport ) ) : 

CREATE INDEX cle ON pratiquée id_personne . i d_sport) ;"; <—0 

i f ( sql i te_exec( $i d_base . $req_tabl es ) ) <— O 
{ 

echo "Les tables sont créées"; 

) 

} 

else echo "ERREUR : $erreur": 
?> 

L'inconvénient de cette méthode est que si une erreur survient dans la création de la 
deuxième ou de la troisième table (incident sur le serveur ou plus simplement erreur dans 
l'écriture d'une seule commande SQL), le script s'arrête, mais la première table a quand 
même été créée. Pour éviter ce genre de problème, vous avez intérêt à utiliser le méca- 
nisme des transactions pour envoyer des requêtes multiples, comme vous le verrez dans 
la suite de ce chapitre. 



Clés composites 

Avec SQLite, il n'est pas possible de créer des clés étrangères ou des clés primaires composites, comme 
il faudrait le faire dans la table pratique. Pour compenser, nous créons un index sur les attributs id_ 
personne et id_sport. Ceci empêchera d'insérer plusieurs fois le même sport pour la même personne 
dans la table. 



La base SQLite 

Chapitre 18 



Insertion de données 

L'insertion de données a déjà été abordée au chapitre 15. Elle ne présente pas de difficul- 
tés particulières dans SQLite. Vous pouvez donc utiliser de la même façon la commande 
SQL INSERT pour procéder à une insertion. Les données insérées dans la base proviennent 
des saisies effectuées par les visiteurs lors de leur inscription sur le site. Vous retrouvez 
ici le code de création d'un formulaire qui vous est familier. La récupération des valeurs 
côté serveur s'effectue également à l'aide de la variable $_POST, qui est un tableau super- 
global accessible dans tous les scripts. 

Dans les tables dans lesquelles il existe une clé primaire auto-incrémentée, il est possible, 
après l'envoi de la requête d'insertion, de récupérer la valeur de la clé en utilisant la fonc- 
tion sql ite_l ast_insert_rowid( ), dont la syntaxe est la suivante : 

I integer sqlite_last_insert_rowid($id_base) 

Les chaînes saisies dans le formulaire peuvent contenir des caractères spéciaux suscepti- 
bles de poser problème lors de leur incorporation aux chaînes de requête SQL. Pour 
protéger ces caractères, il faut appeler la fonction sql ite_escape_stnng( ), selon la 
syntaxe la suivante : 

I string sql ite_escape_string(string Schaine) 

Elle retourne une chaîne dans laquelle les caractères spéciaux sont précédés du caractère 
d'échappement antislash (\). 

L'exemple 18-4 réalise l'insertion des coordonnées d'un visiteur saisies dans un formu- 
laire identique à celui utilisé pour la même fonction à l'exemple 15-7. La gestion des 
données saisies est attribuée au script lui-même dans l'attribut action de l'élément <form> 
(repère Q)- Le visiteur doit saisir son nom, son prénom, son département et son adresse 
e-mail dans des zones de texte nommées respectivement nom, prénom, départ et mail. Le 
script récupère les valeurs saisies dans les variables $nom, $prenom, $depart et $mai 1 à partir 
des variables $_POST[ 'nom' ], $„POST[ 'prénom' ], $_POST[ 'départ' ] et $^POST[ 'mai 1' ] (repè- 
res Q à 0). 

Cette création de nouvelles variables n'a pour objet que d'améliorer la lisibilité du code, 
en particulier celle de la requête SQL d'insertion (repère 0) envoyée par la fonction 
sql ite_exec( ) (repère Q). Si la requête n'est pas exécutée, vous affichez le code d'erreur 
retourné par la fonction sqlite_last_error() (repère©). Dans le cas contraire, vous 
informez le visiteur que l'enregistrement est réalisé en lui communiquant son numéro 
d'enregistrement retourné par la fonction sqlite_last_insert_rowid() et en affichant 
une boîte d'alerte JavaScript (repère 0). Dans tous les cas, la base est ensuite fermée 
(repère ©)• 

'•^ Exemple 18-4. Insertion de données 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" 

"http://www.w3.org/TR/REC-html40/strict.dtd"> 

<html> 

<head> 

<title>Saisissez vos coordonnées</title> 
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<meta http-equiv="Content-Type" content="text/htnil ; charset=IS0-8859-l"> 

</heacl> 

<body> 

<form action^ "<?php echo $_SERVER['PHP_SELF']:?>" niethod="post" 

enctype="appl ication/x-www-form-url encoded"> <— O 

<fieldset> 

<legend><b>Vos coordonnées</b></legend> 
<table> 

<tr><td>Noin : </td><td><inpLit type="text" naiïie="nom" size="40" maxl ength="30"/> 
*»</td></tr> 

<tr><td>Prénoin : </td><td><input type="text" naine="prenom" size="40" 
^niaxlength="30"/></td></tr> 

<tr><td>Département : </td><td><input type="text" nanie="depart" size="40" 
^niaxlength="2"/></td></tr> 

<tr><td>Mail : </td><td><input type="text" name="mail" size="40" maxl ength="50"/> 

^</td></tr> 

<tr> 

<td><input type="reset" value=" Effacer "></td> 

<td><input type="subiïiit" values" Envoyer "></td> 

</tr> 

</table> 

</fieldset> 

</form> 

<?php 

if(!enipty($_POST['noni'])&& !enipty($_POST[' départ']) && !empty($_POST['mair])) 
{ 

$noin= sql i te_escape_string($_POST[ 'nom' ] ) : <— 0 
$prenom= sqlite_escape_string($_POST['prenom']); <— © 
$depart= sql ite_escape_string($_POST[ 'départ ']) ; <— O 
$mai 1 = sql ite_escape_string($_POST[ 'mai 1 ' ] ) ; <— 0 

//Requête SQL 

$requete="INSERT INTO personne VALUESCNULL, '$nom' . '$prenom' , 
^'$depart' . '$mail ' )"; ^0 

$id_base = sqlite_open( 'C:/wamp/www/sqlitemanager/sportifs' , 0666,$erreLir) ; 
$result=sqlite_exec($id_base,$requete) ; <— O 
if( !$result) 
{ 

echo "<h2>Erreur d'insertion \n n' " ,sql i te_l ast_error($id_base) , "</h2>" ; <— 0 



el se 



echo ''<script type^V'text/javascriptX") 

alerte 'Vous êtes enregistré Votre numéro de client est : 

^sql i te_l ast_insert_rowid($id_base) . " ' )</script>" ; <— © 



sqlite_close($id_base) ; <— ® 



else {echo "Formulaire à compléter!";) 
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La figure 18-5 illustre la page de saisie et la boîte d'alerte qui indique l'identifiant du 
client après l'insertion. 
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Figure 18-5 

La page d'insertion et l'affichage du code 



Les transactions 

Dans le cas de la base sportifs, que vous aurez à développer au chapitre 21, quand un 
utilisateur s'inscrit sur le site, il saisit ses coordonnées, le sport qu'il pratique et son niveau. 
Lorsqu'il valide son formulaire, il faut que le script réalise les opérations suivantes : 

1. Récupération des coordonnées du visiteur, du sport et du niveau indiqué dans des 
variables PHP. 

2. Création de la requête d'écriture des coordonnées dans la table personne. 

3. Récupération de l'identifiant du visiteur, qui a été créé dans la table personne, dans la 
colonne id^personne. 

4. Récupération de l'identifiant du sport choisi par le visiteur. 

5. Requête d'écriture de l'identifiant du visiteur, de l'identifiant du sport et du niveau 
dans la table pratique qui représente l'association entre une personne et un sport. 

Si les deux requêtes SQL sont exécutées sans problème, il n'y a pas à se poser de ques- 
tion. Mais que se passe-t-il si, après l'envoi de la première requête ou après la lecture de 
l'identifiant du visiteur, la connexion à la base est interrompue pour une raison quel- 
conque (panne du serveur, erreur dans la deuxième requête, etc.) ? Vous vous retrouvez 
dans la situation où une personne est enregistrée dans la base mais ne correspond à aucun 
sport, ce qui crée une incohérence dans la base. 
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Pour éviter cela, le langage SQL propose le mécanisme des transactions, qui consiste à 
délimiter un ensemble de requêtes qui doivent être exécutées en bloc ou pas du tout. En 
cas de problème avant l'exécution de la deuxième requête SQL, l'effet de la première 
dans la table personne est annulé. La base conserve ainsi son intégrité. 

Examinez d'abord les risques encourus quand les transactions ne sont pas utilisées. 
L'exemple 18-5 illustre ces dangers. La requête qui va être envoyée par la fonction 
sql ite_exec( ) contient deux parties. La première commande insère des données dans la 
table personne (repère Q) st la seconde dans la table pratique (repère ©). Une erreur est 
créée volontairement dans cette deuxième partie car la table pratiques n'existe pas. 
Quand la requête est envoyée à la base, le contrôle effectué par l'instruction if 
(repère 0) affiche que la requête n'a pas été exécutée, et un message d'alerte est affiché 
(repère 0). 

En visualisant le contenu de la table personne avec SQLiteManager, vous pouvez 
constater que les données concernant les coordonnées du visiteur ont quand même été 
insérées dans cette table. Par contre, il n'y a eu aucune insertion dans la table pratique. 
La base a perdu son intégrité car elle contient une ligne dans la table personne qui n'est en 
liaison avec aucune autre dans la table pratique. 

Exemple 18-5. Le danger des requêtes sans transactions 

<?php 

if ($icl_base = sql i te_open( ' C: /wamp2/apps/sql i temanagerl .2.0/sportif s ' ) ) 
{ 

$requete="BEGIN TRANSACTION trans;"; 
sqlite_exec($id_base,$requete) ; 
$requete="INSERT INTO personne(id_personne, nom, prénom, départ, mail ) 
^VALUES (NULL, 'Spencer' , 'Marc' , ' 75 ' , 'marc@spen.org ' ) ; " ; 
$testl= sqlite_exec($id_base,$requete) ; 

$requete=" INSERT INTO pratiques(id_personne,id_sport,niveau) 

^VALUES(last_insert_rowid(),2,3):"; 

$test2= sqlite_exec($id_base,$requete) ; 

if($testl and $test2 ) 
{ 

$requete=''COMMIT TRANSACTION trans"; 

sql ite_exec($id_base,$requete) ; 

echo ''<br />La requête est exécutée<hr />"; 

} 

el se 
{ 

$requete=''ROLLBACK TRANSACTION trans"; 

sql ite_exec($id_base,$requete) ; 

echo "La requête n'est pas exécutée"; 

) 

sqlite_close($id_base) ; 

} 

el se 



La base SQLite 

Chapitre 18 



{ 

echo "ERREUR !"; 

) 

?> 

Pour supprimer ce danger, il faut utiliser les transactions en délimitant l'ensemble des 
commandes SQL à exécuter en tout-ou-rien par la commande BEGIN TRANSACTION avant 
toute autre commande et par la commande COMMIT TRANSACTION après la dernière. Tant que 
cette commande n'est pas rencontrée, aucune insertion n'a lieu. Après son apparition, 
l'ensemble des insertions est réalisé en bloc. 

L'exemple 18-6 reprend la même insertion que l'exemple 18-5 en y ajoutant la commande 
BEGIN TRANSACTION (repère Q) puis l'envoi de deux requêtes d'insertion dans les tables 
personne (repère 0) et pratiques (repère Q avec une erreur volontaire sur le nom de la 
table). Si les deux requêtes sont bien exécutées, la transaction est validée avec l'envoi de 
la commande COMMIT TRANSACTION (repère O), qui évite le danger de l'insertion de lignes 
orphelines. Dans le cas contraire l'ensemble des insertions (sauf les éventuelles comman- 
des SELECT) est supprimé à l'aide de la commande ROLLBACK TRANSACTION (repère 0). 

Exemple 18-6. Utilisation d'une transaction 

<?php 

if ($icl_base = sql i te_open( 'C:/wamp/apps/sql i temanagerl .2.0/sportifs ' ) ) 
{ 

$requete="BEGIN TRANSACTION trans;":<-0 
sql i te_exec($id_base, $requete) ; 
$requete="INSERT INTO personne(id_personne, nom, prénom, départ, mail ) 
^VALUES (NULL, ' Spencer' , 'Marc' , '75 ' , 'marc@spen.org ' ) : " ; 
$testl= sql ite_exec($id_base,$requete) : <— 0 

$requete=" INSERT INTO pratiques(id_personne,id_sport,niveau) 

*VALUES(last_insert_rowid(),2,3):'': 

$test2= sql ite_exec($id_base,$requete) : <— 0 

if($testl and $test2 ) 
{ 

$requete="COMMIT TRANSACTION trans";<-0 

sql ite_exec($id_base,$ requête) ; 

echo "<br />La requête est exécutée<hr />"; 

) 

el se 
{ 

Srequete^'ROLLBACK TRANSACTION trans":<-© 

sqlite_exec($id_base,$requete) ; 

echo "La requête n'est pas exécutée": 

) 

sql ite_close($id_base) ; 

} 

el se 
{ 
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echo "ERREUR !": 

} 

?> 

L'erreur sur le nom de la table pratiques étant maintenue, le script affiche le même 
message d'erreur et le même avis que précédemment, mais cette fois vous êtes assuré 
qu'aucune donnée parasite ne figure dans la base. La commande COMMIT peut aussi être 
envoyée séparément des autres et après avoir envoyé d'autres requêtes, comme c'est le cas 
ici. Ce n'est qu'après cet envoi que les commandes précédentes ont un effet dans la base. 

Lecture des résultats d'une requête 

Comme avec MySQL, vous pouvez récupérer les résultats d'une requête de sélection de 
plusieurs manières différentes, dans un tableau ou une chaîne mais également dans un 
objet. 

Lecture à l'aide d'un tableau 

Si la requête retourne des données de la base, la fonction sql ite_query( ) retourne une 
variable de type resource. Cette dernière sert de paramètre pour les fonctions de lecture 
des données. Vous retrouvez ici des fonctions similaires à celle de la bibliothèque MySQL. 

La plus courante est la fonction sql ite_fetch_array ( ), dont la syntaxe est la suivante : 

I array sql ite_fetch_array ( resource Sresult [, int tab_type]) 

Lors de son premier appel, elle retourne un tableau contenant les données de la première 
ligne du résultat $ resuit retourné par sql ite_query( ). A chaque nouvel appel, ce tableau 
contient la ligne suivante. Pour lire l'ensemble des données par une requête de sélection, 
il faut réaliser une boucle while. La constante tabjype détermine le type du tableau 
retourné. Elle vaut SQLITE_NUM pour un tableau indicé, SQLITE^ASSOC pour un tableau asso- 
ciatif ou SQLITE_BOTH (valeur par défaut) pour un tableau possédant à la fois des indices et 
des clés. 

L'exemple 18-7 utilise cette fonction. L'envoi de la requête de sélection est effectué à 
l'aide de la fonction sql i te_query( ), et les résultats sont identifiés par la variable $resul t 
(repère Q)- Une boucle whi 1 e permet d'effectuer une lecture de l'ensemble en récupérant 
chaque ligne dans le tableau associatif $ligne (repère©). Ses éléments permettent de 
créer un affichage XHTML approprié (repères Q et O). 

'•^ Exemple 18-7. Lecture des résultats d'une requête 

<?php 

if ($icl_base = sqlite_open ("C:/wamp/apps/sqlitemanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

Srequete = "SELECT nom, prénom FROM personne" ; 

if ($result = sqlite_query ($id_base, Srequete) ) <— © 

{ 

echo "<h3>Liste des personnes enregistrées</h3>" ; 
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while($ligne=sqlite_fetch_array($result,SQLITE_ASSOC)) <— 0 
{ 

echo "Nom : <b>{$ligne["nom"]}</b>  ":<— 0 

echo "Prénom : <b>{$l igne["prenoni"]) </b><br />";<—© 

} 

} 

else echo " La requête n'a pas aboutie" ; 
sql i te_cl ose($id_base) ; 

} 

else echo $erreur ; 
?> 

Ce script affiche la liste des personnes inscrites dans la table personne. 



Liste des personnes enregistrées 



Ligne 0 
Ligne 1 
Ligne 2 



nom 
nom 
nom 



Cissai . . 
Dupont. . 
Valmont. 



prénom : 
prénom : 
. prénom 



Gabril . 
Mack. . . 
Paul .. 



Ligne 8 



Zidene... prénom : Zazou. 



Il est possible de récupérer en une seule fois toutes les lignes de résultats dans un seul 
tableau en utilisant la fonction sql ite_fetch_al 1 ( ), dont la syntaxe est la suivante : 

I array sql ite_fetch_al 1 (resource Sresult [, int tab_type]) 

Elle utilise encore un identifiant de résultat retourné par la fonction sql ite_query( ). Le 
tableau retourné est multidimensionnel, chacun de ses éléments étant lui-même un 
tableau. Vous devez utiliser deux boucles imbriquées pour lire l'ensemble des données. 
L'exemple 18-8 réalise la même opération que l'exemple 18-7 en utilisant cette fonction. 
Le tableau retourné par la fonction sql ite_fetch„al 1 ( ) contient ici toutes les lignes du 
résultat (repère O). Vous utilisez deux boucles imbriquées for (repère©) et foreach 
(repère 0) pour parcourir ce tableau et afficher l'ensemble des données. 

<^ Exemple 18-8. Lecture de l'ensemble des lignes 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqliteinanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

Srequete = "SELECT nom, prénom FROM personne" : 
if (Sresult = sqlite_query ($1d_base, $requete)) 
{ 

echo "<h3>Liste des personnes enreg1strées</h3>" ; 
$lignes=sql1te_fetch_all {$result,SQLITE_ASSOC); <-© 
for($i=0:$i<count($lignes):$i++) 

{ 

echo "Ligne $i :  "; 
foreach($lignes[$1] as $cl e=>$val eur) <— © 
{ 

echo $cle," :   " ,$valeur, " . . .  " ; 
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) 

echo "<br />"; 

} 

) 

else echo " La requête n'a pas aboutie" ; 

} 

else echo $erreur ; 
?> 

Quand il est prévisible que la requête ne retourne qu'un nombre limité de lignes, que 
vous estimez à une quarantaine au maximum, il peut être plus rapide d'utiliser la fonction 
sql ite_array_query( ), dont la syntaxe est semblable à celle de sql ite_query( ) : 

I array sql ite_array_query (resource $id_base,string Srequete [,int tab_type]) 

Elle envoie la requête à la base identifiée par $id_base et retourne directement chaque 
ligne de données dans un tableau indicé ou associatif selon la valeur de la constante tab_ 
type. Si la requête porte sur plusieurs attributs d'une table, le tableau retourné est toujours 
multidimensionnel. L'élément d'indice 0 est un tableau indicé ou associatif selon la 
valeur du troisième paramètre. Il contient les données de la première ligne de résultats. Si 
ce tableau est associatif, les clés sont les noms des colonnes de la table, et les valeurs 
celles des champs correspondants. 

L'exemple 18-9 illustre cette possibilité de lecture des résultats d'une requête de sélec- 
tion. Le tableau multidimensionnel $1 ignés obtenu (repère O) est lu à l'aide de deux 
boucles imbriquées. La première boucle for parcourt les éléments du tableau $1 ignés 
(repère 0), et la seconde boucle foreach lit les éléments du tableau associatif $1 ignes[$i ] 
en récupérant les clés et les valeurs associées (repère 0). 

<^ Exemple 18-9. Lecture de l'ensemble des lignes 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqlitemanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

$requete = "SELECT nom, prénom, mail FROM personne" ; 

echo "<h3>Liste des personnes enregistrées</h3>" ; 

$1 ignes=sql ite_array_query($id_base.$requete,SQLITE_ASSOC) ; <— O 

for($i=0;$i<count($lignes) :$i++) <— 0 

{ 

echo "Ligne $i :  ": 

foreach($l ignes[$i ] as $c1e=>$valeur) <— 0 

{ 

echo $cle," :  ",$valeur,". . . ": 

} 

echo "<br />" ; 

) 

sql i te_cl ose($id_base) ; 

} 

else echo Serreur ; 
?> 
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Pour des recherches particulières, qui ne concernent qu'une seule colonne de la table 
interrogée, il est plus rapide de lire le résultat à l'aide de la fonction sql ite_fetch_ 
singleO, qui retourne à chaque appel uniquement la première colonne de chaque ligne 
du résultat $resul t obtenu après une requête. 

La syntaxe de cette fonction est la suivante : 

I string sqlite_fetch_single (resource Sresult) 

Elle est utilisée dans l'exemple 18-10 pour trouver l'adresse e-mail d'une personne dont 
le nom est connu (repère Q)- Après l'appel de cette fonction, la variable $1 igne contient 
l'adresse e-mail recherchée (repère 0). Notez que si le résultat contient plusieurs lignes, 
un nouvel appel de la fonction retourne la valeur de la première colonne de cette seconde 
ligne, et ainsi de suite. 

'•^ Exemple 18-10. Lecture d'une seule colonne 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqlitemanagerl.2.0/sportifs", 0666. 

^$erreur) ) 

{ 

Srequete = "SELECT mail FROM personne WHERE noin=' Engels'" : <— O 
if (Sresult = sqlite_query ($id_base, Srequete)) 

{ 

$1 igne=sqlite_fetch_single($result) ; <— 0 
echo "<h3>Mail : $1 igne</h3>" ; 

} 

else echo " La requête n'a pas aboutie" ; 

} 

else echo $erreur ; 
?> 

Pour lire n'importe quelle colonne particulière d'un résultat, vous devez utiliser la fonc- 
tion : 

■ mixed sql ite_col umn (resource $result, mixed num|nom) 

qui retourne la valeur de la colonne précisée soit par sa position numérique dans la 
requête, soit par son nom ou son alias. Chaque nouvel appel de cette fonction retourne 
la ligne suivante du résultat. 

Informations sur le résultat 

A partir d'un résultat de requête, vous pouvez obtenir des renseignements sur les données 
retournées par une requête de sélection. La fonction suivante : 

I string sqlite_field_nanie (resource $result, int num) 

retourne le nom de la colonne située à la position num dans la requête, et non dans la table. 
Elle peut servir à faciliter la lecture du résultat quand la requête est construite dynami- 
quement à partir de choix opérés par le visiteur. 
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Pour obtenir le nombre de colonnes d'un résultat, vous disposez de la fonction sql ite_ 
num_f i el ds ( ) , dont la syntaxe est la suivante : 

I int sql ite_nLini_fields (resource Sresult) 

Le nombre de lignes du résultat peut être obtenu en appelant la fonction sqlite_num_ 
rows( ), dont la syntaxe est la suivante : 

I int sql ite_num_rows (resource Sresult) 

Elle peut être utilisée, par exemple, pour afficher le nombre de résultats ou pour créer des 
boucles for de lecture de l'ensemble des lignes d'un résultat à la place d'une boucle 
whi 1 e. 

Quand vous effectuez une requête de mise à jour ou de modification de lignes de une ou 
plusieurs tables, vous pouvez obtenir le nombre de lignes qui ont été modifiées grâce à la 
fonction sql ite_changes( ), dont la syntaxe est la suivante : 

I int sql ite_changes (resource $id_base) 
Précaution 

Le nombre retourné concerne toute la base et non pas une seule table. En effet, une requête peut concer- 
ner plusieurs tables ! 



Lecture dans un objet 

Comme vous l'avez déjà vu avec MySQL, il est possible de récupérer les données issues 
d'une requête de sélection dans un objet grâce à la fonction sql ite_fetch_object( ) . dont 
la syntaxe est la suivante : 

I object sqlite_fetch_object (resource Sresult) 

L'objet retourné a autant de propriétés que la requête SQL a sélectionné de colonnes 
dans une ou plusieurs tables de la base. Le nom de ces propriétés est celui des colonnes 
de la table ou des alias éventuels. A chaque nouvel appel, l'objet retourné contient donc 
la ligne suivante du résultat identifié pariresult obtenu par la fonction s q 1 i t e_q u e ry ( ) . 

L'exemple 18-11 reprend la lecture de la totalité de la table personne et affiche les noms 
et prénoms de l'ensemble des personnes enregistrées ainsi que leur e-mail. Vous utilisez 
encore une boucle whi le pour parcourir toutes les lignes du résultat (repère O). Il est 
possible d'afficher les valeurs de chaque colonne en affichant les propriétés de l'objet 
$obj (repères 0, Q et ©) au moyen de la syntaxe $nom_objet->nom_prop. Si vous utilisez 
un alias, le nom de la propriété est bien celui de l' alias et non plus celui de la colonne de 
la table (repère Q). 

Exemple 18-11. Lecture à l'aide d'un objet 

|<?php 
if ($id_base = sqlite_open ("C:/wamp/apps/sqlitenianagerl.2.0/sportifs", 0666, 
^Serreur) ) 



La base SQLite 

Chapitre 18 



Srequete = "SELECT nom, prénom, mail AS 'adresse_mail ' FROM personne" ; 
if ($result = sqlite_query ($id_base, $requete)) 

{ 

$nb=sqlite_nLim_rows($result) : 

echo "<h3>Liste des $nb personnes enregistrées</h3>" ; 

whi 1 e($obj=sql i te_fetch_object($resul t) ) <— O 

{ 

echo " <b>$obj->nom</b>  ":<— 0 
echo " <b>$obj->prenom</b> : &nbsp:";<— © 
echo " <b>$obj->adresse_mai l</b>  ":<— © 
echo "<br />"; 

} 

} 

else echo " La requête n'a pas aboutie" ; 
sql i te_cl ose($id_base) ; 

} 

else echo Serreur ; 
?> 

Accès à une ligne quelconque d'un résultat 

Les fonctions précédentes retournent généralement une ligne de données puis pointent 
sur la suivante et obligent à effectuer un parcours séquentiel des lignes du résultat. Un 
ensemble de fonctions permettent la lecture des lignes dans un ordre quelconque. Cela 
introduit la notion de pointeur de résultat, comme il existe un pointeur de tableau. 

La fonction sql i te_seek( ) permet de positionner le pointeur à la ligne désirée. Sa syntaxe 
est la suivante : 

I boolean sqlite_seek(resource $result,integer num_ligne) 



Indice de première ligne 

Prenez garde à nouveau que la première ligne a l'indice 0. 



Elle retourne TRUE si l'opération est réalisée et FALSE dans le cas contraire (si la ligne 
demandée n'existe pas). 

La fonction sql ite_next( ), dont la syntaxe est la suivante : 
I boolean sqlite_next(resource Sresult) 

pointe quant à elle sur la ligne suivante du résultat et retourne également TRUE ou FALSE 
dans les mêmes conditions. 

La fonction sql ite_rewind( ) replace le pointeur de résultat sur la première ligne, ce qui 
permet de recommencer la lecture. Sa syntaxe est la suivante : 

I boolean sqlite_rewind(resource Sresult) 

Elle retourne également une valeur booléenne. 
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Pour savoir s'il reste encore des lignes à lire dans le résultat, vous pouvez avoir recours à 
la fonction sql ite_has_more( ), dont la syntaxe est la suivante : 

[ boolean sqlite_has_more(resource $result) 

et qui retourne aussi une valeur booléenne si la condition est vérifiée. 

La seule fonction de lecture de la ligne en cours désignée par le pointeur de résultat à 
l'aide des fonctions ci-dessus est sql ite_current( ), dont la syntaxe est la suivante : 

I array sql ite_current( resource Sresult. integer tabjype) 

Elle retourne la ligne en cours dans un tableau indicé ou associatif selon la valeur de la 
constante tab_type, laquelle vaut encore SQLITE_BOTH par défaut. Contrairement aux fonc- 
tions de lecture déjà rencontrées, par exemple, sqlite_fetch_array(), après l'appel de 
sql ite_current( ), le pointeur de résultat n'est pas placé sur la ligne suivante. Il faut utili- 
ser les fonctions précédentes pour le déplacer selon les besoins. Pour lire rapidement 
l'ensemble des résultats dans l'ordre normal, vous ne pouvez donc pas envisager d'utili- 
ser cette fonction, qui est plus adaptée à une lecture dans un ordre irrégulier. 

L'exemple 18-12 utilise la plupart des fonctions précédentes pour effectuer une lecture 
particulière des résultats. Après l'ouverture de la base et l'envoi de la requête de la 
manière habituelle, vous récupérez le nombre total de lignes du résultat dans la variable 
$max (repère O)- Ce nombre est utilisé pour créer la condition d'arrêt d'une boucle for 
(repère 0), qui vous permet de lire les lignes de cinq en cinq à partir de la troisième 
(d'indice 2). A l'intérieur de cette boucle, le pointeur est placé à la position $i par 
la fonction sql ite_seek( ) (repère©). La ligne est lue (repère©) puis affichée avec la 
fonction print_r( ) (repère 0). 

Après chaque lecture, vous contrôlez s'il existe encore des lignes à lire (repère ©). Si 
c'est le cas, le pointeur est placé sur la ligne suivante (repère ©), qui est lue à son tour 
(repère ©). 

La table personne contient ici treize enregistrements, dont les indices varient de 0 à 12 
dans le résultat. La boucle for lit donc les lignes d'indice 2, 7 et 12, tandis que l'utilisa- 
tion de la fonction sql ite_next( ) permet de lire les lignes d'indice 3 et 8. La fonction 
sql ite_has_more( ) réalise un test qui permet d'éviter une erreur en tentant de lire une 
ligne d'indice 13, qui n'existe pas. 

Exemple 18-12. Lecture irrégulière des lignes 

<?php 

if ($id_base = sqlite_open ("C:/wamp/apps/sqliteinanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

$requete = "SELECT id_personne.nom FROM personne" ; 
if ($result = sqlite_query ($id_base, Srequete)) 
{ 

$max=sql ite_num_rows($resul t) ; <— O 
for($i=2:$i<$niax:$i+=5) <— © 

{ 
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sql ite_seek($resul t ,$i ) : <— © 
$ligne=sqlite_current($result,SQLITE_ASSOC) : <— O 
print_r($l igne) : <— 0 
echo "<hr />"; 

if (sql ite_has_more($resul t) ) <— © 
{ 

sqlite_next($resLilt) ; <— © 

$ligne=sqlite_current($result.SQLITE_ASSOC) : <— © 
print_r($l igne) ; 
echo "<hr />"; 



Vous obtenez un résultat de la forme suivante, dans lequel le premier nombre est la valeur 
de l'identifiant de chaque personne dans la table. 



Array 


[id_personne] 


=> 


3 [nom] => Valmont ) 


Array 


[id_personne] 




4 [nom] => Qwetz ) 


Array 


[id_personne] 


=> 


8 [nom] => Engels ) 


Array 


[id_personne] 




9 [nom] => Zidene ) 


Array 


[id_personne] 




13 [nom] => Wind ) 



Création de fonctions SQL personnalisées 

Le langage SQL offre un grand nombre de fonctions utilisables dans les requêtes. Au cas 
où vous auriez besoin d'une fonction qui n'existe pas, SQLite vous permet de créer vos 
propres fonctions et de les enregistrer. L'avantage de cette technique est qu'une fonction 
écrite dans une requête est appliquée automatiquement à toutes les lignes du résultat pour 
les colonnes choisies dans la requête SQL. Cela évite de devoir effectuer un traitement 
répétitif a posteriori sur les données après lecture des lignes. 

Pour parvenir à ce résultat, il suffit de suivre les deux étapes suivantes : 



1. Créez une fonction personnalisée à l'aide de code PHP selon la méthode habituelle 
(voir le chapitre 7). 

2. Déclarez cette fonction comme utilisable par SQLite à l'aide de la fonction sqlite_ 
create_function( ), selon la syntaxe suivante : 

boolean sqlite_create_function(resource $id_base, string nom_sql , string nom_php 
^[.integer nb_param]) 



} 



else echo " La requête n'a pas aboutie" ; 
sql ite_close($id_base) : 



else echo "ERREUR 
?> 



",$erreur ; 
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Le paramètre nom_sql est le nom qui servira à appeler la fonction personnalisée dans le 
code SQL. Il doit être différent d'un nom de fonction SQL existant. Le paramètre nom_php 
est le nom de la fonction personnalisée qui a été créée dans le code PHP à l'étape précé- 
dente. Le paramètre nb_param précise le nombre de paramètres nécessaires à cette fonc- 
tion. Bien que facultatif, il est préférable de l'utiliser pour les fonctions ayant un nombre 
fixe de paramètres. 

Pour utiliser une fonction PHP native dans une requête SQL, la technique est encore plus 
simple car vous disposez d'une fonction généraliste spéciale nommée phpO, qu'il n'est 
pas nécessaire d'enregistrer avec sql ite_create_function( ). 

La fonction php( ) s'utilise directement dans une requête selon la syntaxe suivante : 
I php(string noni_php, nom_col onne) 

Le paramètre nom_php doit désigner une des fonctions natives de PHP, à condition qu'elle 
puisse recevoir comme paramètre une valeur compatible avec celle de la colonne à 
laquelle elle s'applique. 

Si vous écrivez, par exemple, le code suivant : 

I $requete="SELECT php( 'strtoupper' .nom), php( 'strtolower' ,mail ) FROM personne"; 

vous obtenez la liste de tous les utilisateurs, avec leur nom en majuscules et leur e-mail 
en minuscules, quelles que soient les casses des données de la base. 

L'exemple 18-13 crée une fonction personnalisée nommée présent, qui retourne une 
chaîne dont l'initiale seule est en majuscule (repère O)- Cette fonction est enregistrée 
par SQLite sous le nom initiale (repère 0). Elle est ensuite utilisée sous ce nom dans 
une requête SQL (repère 0). Dans la même requête, vous utilisez une fonction native du 
langage SQL, la fonction upper( ), et une fonction native de PHP par l'intermédiaire de la 
fonction générale php( ) (repère 0). L'affichage des résultats est ensuite réalisé en utili- 
sant les indices du tableau $1 i gne (repère 0) puis les clés de ce même tableau (repère 0). 



Attention 

Pour utiliser les clés du tableau $1 ignés, vous devez impérativement définir des alias. Ces derniers 
doivent être les clés du tableau pour les colonnes auxquelles vous appliquez des fonctions personnalisées 
ou PHP, faute de quoi vous n'obtenez aucun résultat. Cela n'est pas nécessaire si vous utilisez seulement 
les indices pour l'affichage des données. 



'•^ Exemple 18-13. Création d'une fonction SQL 

<?php 

function present($mot) <— O 
{ 

return ucf i rstCstrtol ower($mot) ) ; 

} 

if ($id_base = sql1te_open ("C:/wamp/apps/sql1tenianagerl.2.0/sportifs", 0666, 

^Serreur) ) 

{ 
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sql ite_create_functionC$id_base, 'initiale' , 'présent ' , 1) ; <— 0 
Srequete = "SELECT upper(noin) AS nom, initiale(prenom) AS prénom, 
^php( ' strtol ower ' ,mai 1 ) FROM personne" ; <— © 
if ($result = sqlite_query ($id_base, $requete)) 
{ 

echo "<h3>Liste des personnes enregistrées</h3>" ; 

while($ligne=sqlite_fetch_array($result,SQLITE_BOTH)) 

{ 

echo "Nom : ", $ligne[0] ," Prénom : ", $ligne[l] , " Mail : ", $ligne[2], 
^"<br />": <-0 

echo "Nom : ", $ligne['nom'] ," Prénom : ", $1 igne[ 'prénom' ] , " Mail : ", 
^ $ligne['mair] ,"<br />":<-0 

} 

) 

else echo " La requête n'a pas aboutie" ; 
sql i te_cl ose($id_base) ; 

} 

else echo Serreur ; 
?> 

Le résultat obtenu a la forme suivante : 



Liste des personnes enregistrées 

Nom : CISSAI Prénom : Gabril Mail : gabril@qsdfg.com 

Nom : CISSAI Prénom : Gabril Mail : gabril@qsdfg.com 

Nom : DUPONT Prénom : Mack Mail : azertyu@sdfg 

Nom : DUPONT Prénom : Mack Mail : azertyu@sdfg 



La méthode objet 

Le fait de pouvoir accéder de manière native à une base SQLite à l'aide d'objets confirme 
l'orientation objet donnée à PHP 5. Même si la méthode objet est fondamentalement 
différente de la méthode procédurale d'un point de vue conceptuel, vous retrouverez de 
nombreux points communs entre les méthodes des objets manipulés et les fonctions que 
vous avez utilisées précédemment. 

Tout l'accès à SQLite repose sur quatre objets ayant chacun un rôle précis. Il s'agit des 
objets suivants : 

• SQLiteDatabase, qui permet l'ouverture de la base, l'envoi de requêtes et la récupéra- 
tion d'informations après ces envois. 

• SQLiteResult, obtenu après une requête qui retourne des données. Ses méthodes 
permettent de lire les lignes de données retournées par les requêtes de sélection. 

• SQLiteUnbuffered, obtenu après une requête non bufférisée. Il a le même rôle et les 
mêmes méthodes que l'objet SQLiteResult. 

• SQLi teExcepti on, qui permet de gérer les erreurs. 
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Chacun de ces objets possède des méthodes dont les actions sont similaires à celles des 
fonctions utilisées à la section précédente. Vous allez donc réécrire les différents exem- 
ples de cette section en utilisant ces objets et ces méthodes. 



Casse des noms de méthode 

Tous les noms des méthodes de ces objets sont insensibles à la casse. 



>lccès à la base 

Pour accéder à une base SQLite, vous devez d'abord créer un objet SQLiteDatabase en 
utilisant le mot-clé new selon la syntaxe suivante, qui appelle le constructeur de la classe 
avec les mêmes paramètres que la fonction sql ite_open( ) : 

I $clb=new SQLiteDatabase("C:/wan)p/apps/sqliteinanagerl.2.0/sportifs", 0666, $erreur); 

Si la base n'existe pas, elle est créée. Le premier paramètre, qui indique le nom et le 
chemin d'accès à la base, est obligatoire. Si le premier paramètre est la chaîne " :memory : ", 
la base est créée en mémoire vive du serveur. Pour fermer la base, vous détruisez la varia- 
ble $clb en appelant la fonction unset( ) aussitôt que vous n'en avez plus besoin, donc juste 
après l'envoi de la dernière requête du script. 

Envoi de requêtes 

L'objet $db qui vient d'être créé va être utilisé pour envoyer des requêtes à la base avec la 
méthode query( ). Cette dernière est équivalente à la fonction sql ite_query( ), dont le seul 
paramètre est la chaîne de la requête SQL. Pour les requêtes de sélection de données, 
cette méthode retourne un objet SQLiteResult, dont l'utilisation est détaillée à la section 
suivante. 

Si la requête n'est pas exécutée, la méthode retourne la valeur booléenne FALSE. L'exem- 
ple 18-14 représente la forme générale d'un script d'ouverture de la base et d'envoi d'une 
requête. Il équivaut à l'exemple 18-1 mais avec la méthode objet. 

'•^ Exemple 18-14. Script type d'accès à la base 

<?php 

if ($db=new SQLiteDatabase ("C:/wamp/apps/sqlitenianagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

Srequete = "SELECT nom, prénom FROM personne" ; 

if ($resul t=$db->que ry($ requête ) ) 

{ 

unset($db) ; 

echo " La requête a été effectuée " ; 
//Lecture des résultats 

) 

else echo " La requête n'a pas aboutie" ; 

} 
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Ielse echo Serreur ; 
?> 

Pour que le résultat ne soit pas mis en buffer sur le serveur, vous pouvez utiliser la 
méthode unbufferedQuery( ) à la place de queryO. Elle reçoit les mêmes paramètres et 
retourne un objet de type SQLiteUnbuffered au lieu de SQLiteResult. Ces deux objets ont 
les mêmes méthodes, détaillées à la section suivante. 

Pour les requêtes ne retournant pas de données, comme les créations de tables ou les 
mises à jour, par exemple, vous pouvez utiliser la méthode queryExec( ) avec les mêmes 
paramètres que queryO. Elle est plus rapide que cette dernière et retourne TRUE si la 
requête est bien exécutée et FALSE dans le cas contraire. 

Si la requête de sélection à envoyer ne retourne qu'un nombre limité de lignes de résul- 
tats, il est plus rapide d'utiliser la méthode arrayQuery( ), qui permet à la fois d'envoyer la 
requête et de retourner un tableau contenant l'ensemble des résultats. Cette méthode 
permet de ne pas utiliser d'objet SQLiteResult. Sa syntaxe est la suivante: 

I Array $db->arrayQuery(string Srequete, int tab_type) 

Le premier paramètre contient la requête SQL. Le second, tab_type, est une constante qui 
détermine le type du tableau retourné. Il prend les valeurs SQLITE_NUM, SQLITE_ASSOC ou 
SQLITE_BOTH, selon que le tableau est indicé, associatif ou les deux. 

Si la requête porte sur plusieurs colonnes d'une table, le tableau est toujours multidimen- 
sionnel. L'élément d'indice 0 est un tableau qui contient les données de la première ligne 
de résultats. Quand il est associatif, ses clés sont les noms des colonnes ou des alias de la 
requête. 

L'exemple 18-15 illustre la lecture de la table personne au moyen de la méthode objet. 
Après la création de l'objet $db de type SQLiteDatabase (repère O), l'envoi d'une requête 
de sélection par la méthode arrayQueryC ) retourne un tableau multidimensionnel indicé, 
dont les éléments sont des tableaux associatifs (repère ©). Ce tableau est lu à l'aide de 
deux boucles imbriquées, une boucle for pour le premier niveau (repère 0) et une 
boucle f oreach pour les tableaux associatifs (repère O). Les clés de ces derniers, qui sont 
les noms des colonnes de la sélection, sont utilisées pour créer un affichage XHTML des 
données (repère 0). 

Exemple 18-15. Requête de sélection de données 

<?php 

if ($db=new SQLiteDatabase("C:/wanip/apps/sqlitemanagerl.2.0/sportifs", 0666, 
^Serreur)) <— O 

{ 

$requete = "SELECT nom, prénom FROM personne" ; 

if ($result=$db->arrayQuery($requete,SQLITE_ASSOC)) 

{ 

for($i=0:$i<count($result) :$i-H-) <— 0 
{ 

echo "Ligne $i :  "; 
foreach($result[$i] as $cl e=>$val eur) <— 0 
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{ 

echo $cle," :   " ,$valeur, " . . .  " ; <— 0 

} 

echo "<br />"; 

) 

} 

else echo " La requête n'a pas aboutie" ; 

} 

else echo $erreur ; 
?> 

Le résultat de ce script est de la forme suivante: 



Ligne 0 : 


nom : 


Ci ssai . . . 


prénom : 


Gabril 


Ligne 1 : 


nom : 


Dupont. . . 


prénom : 


Mack. . 


Ligne 2 : 


nom : 


Valmont. . 


prénom : 


Paul . . 



Pour des recherches encore plus restreintes, comme celle visant à retrouver l'adresse e-mail 
d'une personne donnée, il est possible d'envoyer la requête et de récupérer le résultat en une 
seule opération, en appelant la méthode s1ngleQuery( ), dont la syntaxe est la suivante : 

I $db->singleQuery(string $requete) 

Si la requête ne retourne qu'une seule valeur, comme à l'exemple 18-16 (repère O), elle 
retourne une chaîne ou un nombre contenant cette valeur, qu'il est très simple d'utiliser 
comme variable scalaire (repère 0). Si la requête retourne plusieurs lignes de données, 
la méthode retourne un tableau indicé ne contenant que les valeurs de la première colonne 
de la requête SQL. 

Si, par exemple, la requête est la suivante : 

|$requete = "SELECT mail , nom, prénom FROM personne"; 
if ($result=$clb->singleQuery($ requête)) 

la variable $resul t est un tableau indicé dont les éléments sont toutes les adresses e-mail de 
la table personne. Les autres colonnes de la requête ne sont pas présentes dans le résultat. 

'•^ Exemple 18-16. Lecture d'une seule valeur 

<?php 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqlitemanagerl.2.0/sportifs")) 
{ 

$requete = "SELECT mail FROM personne WHERE nom='Engels'" ; 

if ($result=$db->singleQuery($reqLiete)) <— O 

{ 

echo "Mail : Sresult <br />":<—© 

) 

else echo " La requête n'a pas aboutie" ; 

} 

else echo Serreur ; 
?> 
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L'objet SQLiteDatabase dispose également de la méthode lastErrorO, qui retourne le 
code de la dernière erreur survenue dans le script. Si aucune erreur ne s'est produite, elle 
retourne la valeur 0. 

Quand vous effectuez une requête de mise à jour ou de modification de données sur une 
ou plusieurs lignes des tables de la base, vous pouvez obtenir le nombre de lignes qui ont 
été modifiées en utilisant la méthode changes ( ), dont la syntaxe est la suivante : 

I int $db->changes( ) 

L'exemple 18-17 réalise une mise à jour des données dans la table personne à l'aide de la 
commande SQL UPDATE (repère O)- Après l'envoi de la requête avec la méthode 
queryExec( ), plus appropriée ici (repère ©), la méthode changes( ) permet de lire et d'affi- 
cher le nombre de lignes modifiées (repère 0). 

f*' Exemple 18-17. Détermination du nombre de lignes modifiées 

<?php 

if ($db=new SQLiteDatabase("C:/wainp/apps/sql itemanagerl.2.0/sportifs") ) 
{ 

Srequete = "UPDATE personne SET niail = 'romy@funhtml .com' WHERE 

*noni=' Engels'" ; <— O 

if ($result=$db->queryExec($requete)) <— 0 

{ 

echo "Il y a " ,$db->changes( ) , " ligne(s) modifiée(s)" ; <— 0 

} 

else echo " La requête n'a pas aboutie" ; 

} 

else echo Serreur ; 
?> 

Après insertion de données dans une table comportant une colonne d'identifiant entier 
auto-incrémenté déclaré par la clause " INTEGER PRIMARY KEY" lors de la création de la table, 
vous pouvez récupérer la valeur qui vient d'être insérée dans cette colonne à l'aide de la 
méthode lastInsertRowid( ) de l'objet $db. 

L'exemple 18-18 réalise l'insertion des coordonnées d'un visiteur dans la table personne 
avec la commande SQL INSERT (repère O). Après l'envoi de la requête avec la méthode 
queryExec( ) (repère 0), le dernier identifiant inséré est lu et affiché à destination du visi- 
teur (repère 0). 

Exemple 18-18. Lecture du dernier champ auto-incrémenté 

<?php 

if ($db=new SQLiteDatabase("C:/wainp/apps/sql itemanagerl.2.0/sportifs") ) 
{ 

$requete="INSERT INTO personne (id_personne, nom, prénom, départ, mail) 
^VALUES (NULL, 'Grouchi ' . 'Karl ' .91. 'karl@grouch.net' )"; 
if ($result=$db->queryExec($requete)) <— 0 
{ 
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echo "Votre identifiant est : " .$db->l astlnsertRowidC ) ; <— 0 

) 

else echo " La requête n'a pas aboutie" ; 

} 

else echo $erreur ; 
?> 

Lecture des résultats et objets spécialisés 

L'objet SQLi teDatabase vous a déjà pemiis une lecture de résultats dans des cas particuliers 
simples. Dans le cas général d'une requête qui retourne les résultats d'une sélection 
portant sur un nombre quelconque de colonnes, vous utilisez systématiquement les 
méthodes queryO ou unbufferedQuery ( ). La première retourne un objet de type 
SQLi teResul t et la seconde un objet de type SQLi telinbuf f ered. Ces deux types d'objets ont 
exactement les mêmes méthodes. La seule différence entre eux réside dans le fait que le 
second représente un résultat qui n'est pas mis en buffer et qui doit donc être 
« consommé » tout de suite, en particulier avant tout autre envoi de requête. 

Les exemples qui suivent n'emploient que l'objet SQLi teResul t. Si vous voulez obtenir 
des résultats non bufférisés, il vous suffit de remplacer la méthode query ( ) par la méthode 
unbufferedQuery( ). 

Lecture à l'aide d'un tableau ou d'une chaîne 

L'objet retourné par la méthode query( ) est récupéré dans la variable $resul t, dont vous 
allez utiliser les différentes méthodes. La méthode la plus courante est fetch{ ), équiva- 
lent de la fonction sql ite_fetch_array( ). Elle retourne un tableau contenant la ligne en 
cours du résultat et prend comme seul paramètre une des constantes SQLITE_NUM, SQLITE_ 
ASSQC ou SQLITE_BQTH, que VOUS avez déjà rencontrées dans la méthode procédurale et qui 
détermine le type de tableau retourné. 

À chaque nouvel appel, cette méthode retourne le contenu de la ligne suivante de résul- 
tats. Pour obtenir la totalité des données, vous écrivez deux boucles imbriquées, une 
boucle while pour chaque ligne et une boucle for ou foreach pour lire les données d'une 
ligne. 

L'exemple 18-19 réalise la même lecture que l'exemple 18-4, mais avec une fonction. 
Après l'ouverture de la base et la création d'un objet SQLiteDatabase (repère 0)> une 
requête SQL classique permet la sélection de tous les noms et prénoms des utilisateurs 
inscrits dans la table personne (repère 0). L'envoi de la requête par la méthode query( ) 
retourne un objet de type SQLiteResult dans la variable $result (repère 0). La destruc- 
tion de la variable objet $db est réalisée aussitôt après pour libérer la base d'un 
verrouillage éventuel (repère 0). Une boucle while lit alors chaque ligne dans un tableau 
associatif $1 igne en appelant la méthode fetch( ) (repère 0). Ce tableau est utilisé pour 
lire chacune des données retournées par la requête (repères 0 et 0). 
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<^ Exemple 18-19. Lecture des résultats ligne par ligne 

<?php 

if ($db=new SQLiteDatabase("C:/wainp/apps/sqlitemanagerl.2.0/sportifs", 0666, 
^Serreur)) <— O 

{ 

Srequete = "SELECT nom, prénom FROM personne" ; <— 0 

if ($result = $db->query($requete) ) <— 0 

{ 

unset($db) ; <-© 

echo "<h3>Liste des personnes enregi strées</h3>" ; 
while($ligne=$result->fetch(SQLITE_ASSOC)) <-0 
( 

echo "Nom : <b>{$ligne["nom"])</b> &nbsp:";<— © 

echo "Prénom : <b>{$l igne["prenom"]} </b><br />";<— 0 

} 

) 

else echo " La requête n'a pas aboutie" ; 
} 

else echo Serreur ; 
?> 

Vous pouvez récupérer l'ensemble des lignes obtenues au moyen d'une requête de sélec- 
tion dans un seul tableau multidimensionnel en utilisant la méthode f etchAl 1 ( ) d'un objet 
SQLiteResult. Cette opération est rapide car elle ne réalise qu'un seul appel de méthode. 
Il faut toutefois l'utiliser pour des requêtes ne retournant qu'un nombre peu important de 
lignes. On imagine aisément l'espace mémoire occupé par un tableau contenant quelques 
milliers de lignes. 

La méthode f etchAl 1 ( ) utilise la syntaxe suivante : 
■ $db->fetchAll (string $requete,int tab_type) 

Le paramètre tab_type, que vous avez utilisé précédemment, spécifie le type de tableau 
retourné. Le tableau étant multidimensionnel, à moins que la requête ne concerne qu'une 
colonne, vous devez utiliser deux boucles imbriquées pour le lire dans son ensemble. 

L'exemple 18-20 lit l'ensemble des résultats de la requête SQL. Il s'agit d'une jointure 
des tables personne et pratique afin de rechercher les coordonnées des personnes prati- 
quant le sport dont l'identifiant est 2, soit le football (repère Q)- La requête envoyée par 
la méthode query( ) retourne la variable $ resuit, qui est un objet SQLite Resuit (repère 0). 
L'objet $db est alors détruit, ce qui libère la base (repère 0). 

L'appel de la méthode fetchAllO pour l'objet $result retourne le tableau $tabl ignés 
(repère 0). L'objet $result peut alors être détruit à son tour (repère 0). Les éléments de 
$tabl ignés sont lus avec une boucle for (repère 0). Chaque élément noté $tabl ignes[$i ] 
est lui-même un tableau associatif qui est lu avec une boucle f oreach (repère 0) et utilisé 
pour créer un affichage des données (repère 0). 
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'■^ Exemple 18-20. Lecture de l'ensemble des lignes dans un seul tableau 

<?php 

if ($clb=new SQLiteDatabase("C:/wamp/apps/sqliteinanagerl.2.0/sportifs", 0666. 

^$erreur) ) 

{ 

Srequete = "SELECT nom, prénom, mail FROM personne, pratique WHERE id_sport='2' 
^AND personne. id_personne=pratique.icl_personne" : <— O 
if ($result = $db->query($requete.SQLITE_ASSOC)) ^© 
{ 

unset($db); <— 0 

echo "<h3>Liste des personnes jouant au football </h3>" ; 
$tablignes=$result->fetchAll(SQLITE_ASSOC): <-© 
unset($result) ; <— © 
for($i=0:$i<count($tablignes) :$i++) <— 0 

{ 

echo "Ligne $i :  "; 

foreach($tablignes[$i] as $cle=>$valeur) <— 0 
{ 

echo $cle." : &nbsp: " .$val eur. " . . .&nbsp: " ; <— 0 

} 

echo "<br />"; 

} 

) 

else echo " La requête n'a pas aboutie" ; 

} 

else echo Serreur ; 
?> 

Le résultat de ce script a la forme suivante : 



Liste des personnes jouant au football 

Ligne 0 : nom : Cissai... prénom : Gabril... mail : gabril@qsdfg.com... 

Ligne 1 : nom : Rousse... prénom : Guy... mail : guitou@poulet.com... 

Ligne 2 : nom : Barthes... prénom : Fabien... mail : fabi@loos.org... 



Dans le cas particulier où la requête de sélection porte sur une seule colonne d'un table, 
comme la recherche des adresses e-mail des utilisateurs dont on connaît le département, 
la méthode fetchSingl e( ) est plus rapide que les précédentes. A chaque appel elle 
retourne la valeur de la première colonne spécifiée dans la requête SQL sous la forme 
d'une chaîne de caractères. 

L'exemple 18-21 réalise avec cette méthode une lecture similaire à celle de l'exemple 
18-7 avec la fonction sql ite_fetch_single( ). La requête SQL sélectionne les e-mails des 
personnes habitant le département de code 13 (repère 0). Après l'envoi de la requête 
avec la méthode queryO (repère 0), la variable $result représente un objet de type 
SQLiteResult auquel vous appliquez la méthode fetchSingle( ). Cette dernière retourne la 
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variable $mail contenant l'information recherchée, qui est ensuite affichée (repère ©). Si 
vous ne vous intéressez qu'à la première valeur, la boucle while est inutile, et vous 
pouvez écrire simplement le code suivant : 

ISmai 1 =$resul t->fetchSingl e( ) ; 
echo "<h4>Mail : $mail </h4>": 

Cela peut être utile pour une requête dont vous savez par avance qu'elle ne retourne 
qu'une seule ligne, comme la recherche du nom d'un utilisateur dont vous connaissez 
l'identifiant unique. 

Exemple 18-21. Lecture d'une seule colonne 

<?php 

if ($db=new SQLiteDatabase("C:/wainp/apps/sql itemanagerl.2.0/sportifs") ) 
{ 

$requete = "SELECT mail FROM personne WHERE depart='13'" ; <— O 

if ($result=$db->Query($requete)) <— © 

{ 

while($mail=$result->fetchSingle()) echo "<h4>Mail : $mail </h4>";<— 0 

} 

} 

else echo Serreur ; 
?> 

Pour lire une colonne précise dans la ligne en cours d'un résultat, vous disposez de la 
méthode col umn( ), qui s'applique à l'objet $result et dont la syntaxe est la suivante : 

I divers $result->col umn(string nom_col | integer num_col ) 

L'unique paramètre précise le nom de la colonne ou de son alias avec une chaîne ou sa 
position dans la requête SQL avec un entier, la première colonne ayant le numéro 0. 

Si la requête est : 

I $requete="SELECT nom, prénom, mail AS adresse_mail FROM personne": 
le code suivant : 

I $mai 1 =$resul t->col umn( ' adresse_mai 1 ' ) ; 
ou encore : 

I $mai 1 =$resul t->col uvvmn(2) : 

permet de ne lire que la colonne des adresses e-mail. 

Informations sur le résultat 

A partir d'un objet SQLiteResult, vous pouvez obtenir des informations sur les données 
retournées par la requête SQL. La méthode suivante : 

I string $result->fieldName(integer N) 
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retourne le nom, ou l' alias, de la colonne située à la position dans la requête. Elle peut 
servir à réaliser un affichage dynamique du nom de la colonne quand il n'est pas connu à 
l'avance. 

De même, pour obtenir le nombre de colonnes d'un résultat, vous pouvez appeler la 
méthode numFields( ) avec le code suivant : 

I $nbcol=$result->numFields( ) ; 

qui peut servir à réaliser une boucle de lecture des résultats. 

Le nombre de lignes retourné dans l'objet SQLiteResult peut être lu au moyen de la 
méthode numRowsC ) selon le code suivant : 

I $nbl igne=$resul t->nuinRows( ) ; 

Ce nombre peut également servir à créer une boucle for de lecture de toutes les lignes. 

Lecture dans un objet 

Méthode objet oblige, il est possible de récupérer les données issues d'une requête de 
sélection dans un objet. Il faut pour cela appeler la méthode fetchObject( ) pour l'objet 
Sresult retourné par une des méthodes d'envoi de requête. L'objet obtenu a autant de 
propriétés que la requête SQL contient de noms de colonnes. A chaque appel, l'objet 
retourné contient la ligne suivante du résultat. 

L'exemple 18-22 réalise au moyen de cette méthode la même opération que l'exem- 
ple 18-11, qui utilisait la fonction sql ite_fetch_object( ). La requête SQL sélectionne les 
coordonnées de toutes les personnes inscrites dans la table personne (repère O). Après 
l'envoi de la requête par la méthode query( ) et la récupération du résultat dans l'objet 
Sresul t (repère 0), la variable $clb est détruite. La lecture des lignes de résultats dans un 
objet est faite par une boucle whi 1 e, qui appelle la méthode fetchObject( ). 

La lecture de chacune des propriétés de l'objet $obj obtenu est faite par une boucle 
foreach (repère O). L'objet Sresult peut ensuite être détruit pour libérer la mémoire. 
Cela n'est utile que si le script contient une suite importante d'instructions (repère Q). 

Exemple 18-22. Lecture à l'aide d'un objet 

<?php 

if ($db=new SQLiteDatabase("C:/wanip/apps/sqliteinanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

Srequete = "SELECT nom, prénom, mail AS ' adresse_mai 1 ' FROM personne" : <— O 

if ($result = $db->query (Srequete) ) <— 0 

{ 

$nb=$resul t->numRows( ) ; 
unset($db) ; <— © 

echo "<h3>Liste des $nb personnes enregistrées</h3>" ; 

while($obj=$result->fetchObject()) 

{ 

echo "<p>"; 
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foreach($obj as $prop=>$val eur) <— © 
{ 

echo "$prop : <b> $valeur </b>": 

} 

echo "</p>"; 

) 

unset($result) : <— © 
} 

else echo " La requête n'a pas aboutie" ; 

} 

else echo Serreur ; 
?> 

Le résultat affiché par ce script est de la forme suivante : 



Liste des 11 personnes enregistrées 

nom : Cissai prénom : Gabril adressejai 1 : gabril@qsdfg.com 

nom : Dupont prénom : Mack adressejai 1 : azertyuSsdfg 

nom : Valmont prénom : Paul adresse_mail : paul@comte.net 



Création de fonctions SQL personnalisées 

Comme vous l'avez déjà réalisé avec la méthode procédurale, il est possible avec la 
méthode objet de créer des fonctions SQL personnalisées utilisables dans des requêtes. 
Vous devez pour cela suivre les mêmes étapes, à savoir la création d'une fonction person- 
nalisée puis son enregistrement au moyen de la méthode createFunction( ) de l'objet 
SQLIteDatabase, qui doit respecter la syntaxe suivante : 

I boolean createFunction(string nom_sql , string nom_php, integer nb) 

Le paramètre nom_sql est le nom par lequel la fonction personnalisée est appelée dans le 
code SQL. Le paramètre nom_php désigne le nom de la fonction dans le code PHP, et nb le 
nombre de ses paramètres. 

L'exemple 18-23 adapte à la méthode objet l'application de l'exemple 18-13, qui utilisait 
la méthode procédurale. Vous créez d'abord la fonction personnalisée présent (repère O), 
qui retourne une chaîne dont l'initiale est en majuscules et les autres lettres en minuscu- 
les. Elle est enregistrée par SQLite sous le nom initiale en appelant la méthode 
createFunction( ) (repère 0) puis utilisée dans une requête SQL (repère 0). L'affichage 
des résultats retourné par la méthode fetch( ) (repère Q) est ensuite réalisé en utilisant 
les indices du tableau $1 i gne (repère 0) puis les clés de ce tableau (repère ©). 



Attention 

Pour utiliser les clés du tableau $1 i gnes, vous devez impérativement définir des alias, qui seront les clés 
de ce tableau pour les colonnes auxquelles vous appliquez des fonctions personnalisées ou des fonctions 
PHP. Sans cela, vous n'obtenez aucun résultat. Cela n'est pas nécessaire si vous utilisez seulement les 
indices. 
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'■^ Exemple 18-23. Création de fonctions SQL personnalisées 

<?php 

function present($mot) <— O 
{ 

return ucf i rstCstrtol ower($niot) ) ; 

} 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqliteinanagerl.2.0/sportifs", 0666, 

^$erreur) ) 

{ 

$db->createFunction( 'initiale' , 'présent' ,1); <— © 

Srequete = "SELECT upper(nom) AS nom, initiale(prenom) AS prénom, 

^php( 'strtolower' .mail ) AS mail FROM personne" : <— © 

if ($result = $db->query (Srequete)) 

{ 

echo "<h3>Liste des personnes enregistrées</h3>" ; 
whi1e($ligne=$result->fetch(SQLITE_B0TH)) 

{ 

echo "Nom : ", $ligne[0] ," Prénom : ". $ligne[l] , " Mail : " . $ligne[2], 
^''<br />"; <-0 

echo "Nom : ", $1 igne[ 'nom' ] , " Prénom : ", $ligne['prenom'], " Mail : ", 
^$ligne['mair] , "<br />" ; <— 0 

} 

} 

else echo " La requête n'a pas aboutie" ; 
unset($db) ; 

} 

else echo Serreur ; 
?> 

Lobjet SQLiteException 

Vous avez déjà rencontré la classe Exception, qui permet la gestion des exceptions surve- 
nant dans un script (voir le chapitre 3). SQLite dispose d'une classe spéciale, nommée 
SQLiteException, dérivée de la précédente. Elles possèdent toutes deux les mêmes 
propriétés et les mêmes méthodes. Il n'y a donc rien de nouveau dans l'utilisation de 
cette classe par rapport à ce que vous avez déjà réalisé. 

Pour illustrer l'emploi d'un objet SQLiteException lors d'un accès à la base sportifs, le 
code de l'exemple 18-24 tente d'accéder à une table qui n'existe pas (elle est appelée 
personnes alors que seule la table personne a été créée). Pour masquer les messages 
d'erreur à l'utilisateur, vous appelez la fonction error_reporting( ), qui bloque l'affichage 
de tous ces messages (repère O). L'ensemble du code de lecture de la table est inclus 
dans un bloc try (repère ©). 

Comme l'envoi de la requête par la méthode query ( ) retourne la valeur FALSE (repère ©), un 
message est affiché, et une exception est déclenchée par l'instruction throw. Cette 
dernière provoque la création d'un objet de type SQLiteException. Vous attribuez à cet 
objet un texte de message d'erreur et un code d'erreur, qui correspondent respectivement 



La base SQLite 

Chapitre 18 



aux propriétés message et code de l'objet, en passant ces deux paramètres à son constructeur 
(repère O)- 

En cas d'erreur, l'exception est gérée par le bloc catch (repère 0). Ce dernier provo- 
que l'affichage successif du message d'erreur, en utilisant la méthode getMessageO 
(repère©), du code d'erreur que vous avez défini en appelant la méthode getCodeO 
(repère©) et de la ligne à laquelle l'exception a été créée en appelant la méthode 
getLine( ) (repère 0). 

Ces informations, surtout utiles aux programmeurs, sont gênantes pour les visiteurs du 
site. Dans la pratique, vous vous dispenseriez de les afficher en détail et vous contente- 
riez de les envoyer, par exemple, par e-mail au webmestre du site. A l'inverse, il peut être 
utile de rendre visible à l'utilisateur un message plus présentable sous la forme d'une 
boîte d'alerte créée avec la fonction JavaScript alertO que vous connaissez bien. Vous 
réalisez cela dans le bloc catch en créant un élément XHTML <script> (repère ©). 

f*' Exemple 18-24. Gestion des exceptions SQLite 

<?php 

// Suppression des avis d'erreurs 
error_reporting(0) : <— O 
try ^0 

{ 

if ($db=new SQLiteDatabase("C:/wamp/apps/sqlitemanagerl.2.0/sportifs")) 

{ 

Srequete = "SELECT mail FROM personnes WHERE depart^'lS'" ; 

if ( ! $resul t=$db->query($ requête ) ) <— 0 

{ 

echo "<h2>ERREUR SQLITE</h2>" ; 

throw new SQLiteExceptionC'Erreur de requête SQLite" ,67) ; <—0 

} 

el se 

{ 

while($mail=$result->fetchSingle()) echo "<h4>Mail : $mail </h4>": 

} 

} 

} 

catchCSQLiteException Smyexcept) <— 0 
{ 

echo "<h2>MESSAGE : " , $myexcept->getMessage( ) , "</h2>" : <— 0 
echo "<h2>C0DE : " ,$myexcept->getCode( ) . "</h2>" ; <— 0 
echo "<h2>LIGNE : " .$myexcept->getLine( ) , "</h2>" ; <-0 
echo "<script> alert( 'Désolé! ERREUR SQLite Numéro : ", 
*$myexcept->getCode( ) , " ' )</script> " ; <— 0 

} 

?> 

Le résultat affiché par ce script est illustré à la figure 18-6. 
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Figure 18-6 

Résultat obtenu en cas d'erreur 



Accès à SQLite avec PDO 

Il est également possible d'accéder à une base SQLite au moyen de PDO, comme nous 
l'avons fait au chapitre 17 pour MySQL. Il faut, pour cela, réaliser la connexion en créant 
un objet PDO au moyen de son constructeur selon la syntaxe : 

$db=new PDO( "sql i te2:C: /wamp2/apps/sql itemanagerl .2. 0/sportif s" ) 

Cette ligne de code permet d'accéder à notre base sportifs créée précédemment. Pour 
une base SQLite 3, il faudra écrire sql ite3 en début de chaîne de connexion. L'objet $db 
obtenu représente la connexion de la même façon que dans les sections ci-dessus. Toutes 
les méthodes des objets PDO étudiées au chapitre 17 sont également utilisables pour 
gérer la base SQLite et nous ne les détaillerons pas ici. L'exemple 18-25 illustre une 
connexion réalisée avec PDO (repère 0)> suivie de l'envoi au serveur d'une requête de 
sélection au moyen de la méthode queryO (repère 0), puis de la lecture des lignes 
de résultat à l'aide de la méthode fetch( ) (repère ©). Hormis la chaîne de connexion à la 
base, écrite dans le constructeur de l'objet PDO, vous pouvez constater qu'il n'y a rien de 
neuf ici, et c'est tout l'intérêt de PDO, le même script pouvant être réutilisé pour des 
bases de type très différent au prix d'une modification mineure. 

'•^ Exemple 18-25 Connexion avec PDO 

<?php 

if ($db=new PDO( "sql ite2:C:/wamp2/apps/sql itemanagerl.2.0/sportifs") ) <— O 



{ 



Srequete = "SELECT id_personne as 'Numéro', nom as 'Nom', prénom as 'Prénom', 

^mail FROM personne" ; 

if ($result=$db->query($requete)) <— 0 
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unset($clb) ; 

//Lecture des résultats 
echo "<h3>Résultats </h3>": 

while($tab=$result->fetch(PDO: :FETCH_ASSOC)) <-© 
{ 

foreach($tab as $cl e=>$val eur) 
{ 

echo $cle," :    " ,$val eur , "   ;"; 

} 

echo "<br />" ; 

} 

) 

else echo " La requête n'a pas aboutie" ; 

} 

else echo "ERREUR" ,$erreur ; 
?> 



Mémo des fonctions 

array sql ite_array_query (resource $id_base, string $requete [, int tab_type]) 

Envoie une requête à la base et retourne un tableau contenant toutes les lignes du résultat. 

void sql 1 te_busy_tiineout (resource $id_base. int N) 

Fixe le délai d'attente à N milliseconde quand la base est verrouillée par un autre accès. 

int sql ite_changes (resource $id_base) 

Retourne le nombre de lignes modifiées par la dernière requête SQL. 

void sqlite_close (resource $id_base) 

Ferme la base pour l'accès identifié par $id_base. 

mixed mixed sql ite_col umn (resource $result, mixed num|nom) 

Retourne le contenu d'une colonne identifiée par son nom ou son numéro dans la ligne en cours. 

bool sql ite_create_functicn (resource $id_base, string noin_sql , string nom_php [, int nb_parani]) 

Enregistre la fonction noiïi_php pour pouvoir l'utiliser dans une requête SQL sous le nom ncm_sql . 

array sql ite_current (resource $result [, int tab_type]) 

Retourne la ligne en cours dans un tableau dont le type dépend de la constante tab_type, laquelle prend les valeurs 
SQLITE_BOTH, SQLITE_NUM ou SQLITE_ASSOC. 

string sql ite_error_string (int N) 

Retourne le dernier message d'erreur. 

string sql ite_escape_string (string $ch) 

Ajoute le caractère d'échappement devant les caractères spéciaux des chaînes à insérer dans la base, 
boolean sql ite_exec( resource $id_base, string $requete) 

Envoie une requête à la base. Utilisable seulement pour les requêtes ne retournant pas de résultat. 
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array sql ite_fetch_al 1 (resource $result[, integer tab_type]) 
Retourne l'ensemble des lignes du résultat dans un seul tableau multidimensionnel. 
array sqlite_fetch_array ( resource $result [, int tab_type]) 

Retourne la ligne en cours du résultat dans un tableau dont le type est déterminé par la constante tab_type. 
object sql ite_fetch_object(resource $result) 

Retourne la ligne en cours du résultat dans un objet dont les propriétés ont pour noms ceux des colonnes sélectionnées 
dans la requête. 

string sql i te_fetch_si ngl e (resource $result) 

Retourne la première colonne du résultat dans une chaîne. 

string sql i te_f iel djame (resource $result, int numcol ) 

Retourne le nom de la colonne placée à la position numcol dans la requête. 

bool sql ite_has_inore (resource $result) 

Indique s'il reste encore des lignes non lues dans le résultat. 

int sql ite_l ast_error (resource $id_base) 

Retourne le dernier code d'erreur. 

int sql i te_l ast_insert_rowid (resource $id_base) 

Retourne la dernière valeur insérée dans une clé primaire auto-incrémentée. 

string sql i te_l ibencoding (void ) 

Retourne le nom du jeu de caractères utilisé par SQLIte (par exemple ISO 8859). 

string sql i te_l ibversion (void ) 

Retourne le numéro de version de SQLIte. 

bool sqlite_next (resource $result) 

Place le pointeur de résultat sur la ligne suivante. 

int sql i te_num_f i el ds (resource $result) 

Retourne le nombre de colonnes du résultat. 

int sql ite_num_rcws (rescurce $result) 

Retourne le nombre de lignes du résultat. 

resource sqlite_cpen (string nom_base [, int mode [, string $erreur]]) 

Ouvre la base nommée ncm_base. Ce paramètre peut être un chemin d'accès complet. Retourne un identifiant de 
connexion, ou FALSE en cas d'erreur. 

resource sqlite_popen (string filename [, int mode [, string $erreur]]) 

Ouvre une connexion persistante à la base. Retourne un identifiant de connexion, ou FALSE en cas d'erreur. 

resource sqlite_query (resource $id_base, string $requete) 

Envoie une requête à la base identifiée par $i d_base et retourne un identifiant de résultat, ou FALSE en cas d'erreur, 
bool sql ite_rewind (resource resuit) 
Replace le pointeur de résultat à la première ligne. 
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bool sqlite_seek (resojrce resuit, int N) 
Place le pointeur de résultat à la ligne N. 

resource sql i te_unbuffered_query (resource $id_base, string $requete) 

Envole une requête à la base et retourne un Identifiant de résultat, ou FALSE en cas d'erreur. Le résultat n'est pas mis en 
buffer et doit être utilisé avant l'envoi de toute autre requête. 



Mémo des méthodes des objets 

Dans la syntaxe des méthodes ci-dessous, la variable $db désigne un objet SQLiteDatabase 
et la variable $result un objet SQLiteResult ou SQLiteUnbuffered. 

array $db->arrayQuery(string Srequete, integer tab_type) 

Envole une requête à la base et retourne un tableau contenant toutes les lignes du résultat. Le paramètre tab_type déter- 
mine le type du tableau. Il prend les valeurs SQLITE_BOTH, SQLITE_NUM ou SQLITE_ASSOC. 

void $db->busy_timeout(integer N) 

Fixe le délai d'attente admissible à N milliseconde. 

integer $db->clianges( ) 

Retourne le nombre de lignes modifiées dans la base par la dernière requête. 

divers $result->column(integer numcol | string nomcol ) 

Retourne le contenu de la colonne Indiquée par son Indice ou par son nom dans la ligne en cours du résultat, 
boolean $db->createFunction(string nom_sql , string nom_pfip [, integer N]) 

Enregistre la fonction personnalisée nom_php sous le nom nom_sql pour pouvoir l'utiliser dans des requêtes SQL. 
W désigne le nombre de paramètre de la fonction nom_pfip. 

array $result->current(integer tab_type) 

Retourne la ligne en cours dans un tableau dont le type est précisé par tab_type. 
array $result->fetcfi(integer tab_type) 

Retourne la ligne en cours dans un tableau indicé ou associatif selon la valeur de tab_type. 
array $result->fetcfiAll (integer tab_type) 

Retourne toutes les lignes du résultat dans un tableau multidimenslonnel indicé ou associatif selon la valeur de tab_ 
type. 

object $resul t->fetchObject( ) 

Retourne la ligne en cours dans un objet dont les propriétés ont pour noms ceux des colonnes présentes dans la requête, 
string $result->fecthSingle( ) 

Retourne la valeur de la première colonne de la ligne en cours du résultat. 

string $result->fieldNaine(integer N) 

Retourne le nom de la colonne d'indice N dans le résultat. 

boolean $resul t->hasPrev( ) 

Retourne TRUE s'il existe une ligne précédente dans le résultat et FALSE dans le cas contraire. 
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integer $db->l ast_error( ) 
Retourne le code de la dernière erreur, 
integer $db->l ast_insert_rowid( ) 

Retourne la dernière valeur entière insérée dans une colonne auto-incrémentée. 
boolean $resul t->next( ) 

Place le pointeur de résultat sur la ligne suivante. Retourne TRUE si elle existe et FALSE dans le cas contraire. 

integer Iresul t->numFiel ds( ) 

Retourne le nonnbre de colonnes présentes dans le résultat. 

integer $result->numRows( ) 

Retourne le nombre de lignes présentes dans le résultat. 

object $db->query(string $requete) 

Envoie une requête à la base $db et retourne un objet SQLiteResult. 
boolean $db->queryExec(string Srequete) 

Envole une requête ne retournant pas de résultat à la base $db et retourne TRUE ou FALSE. 
boolean $result->rewind( ) 

Replace le pointeur de résultat à la première ligne. Retourne TRUE si l'opération a réussi et FALSE dans le cas contraire, 
boolean $result->seek(integer N) 

Place le pointeur de résultat à la nième ligne. Retourne TRUE si l'opération a réussi et FALSE dans le cas contraire, 
string I integer $db->singleQuery(string $requete) 

Envole une requête à la base $db et retourne la valeur de la première colonne de la ligne en cours. 

object $db->unbufferedQuery(string $requete) 

Envole une requête à la base $db et retourne un objet SQLiteUnbuffered. 

Pour les méthodes des objets PDO vous pouvez vous référer au mémo du chapitre 17. 

Exercices 

Le but de ces exercices est de réaliser avec SQLite la même application que celle réalisée 
avec MySQL au cours des exercices des chapitres 13 et 14. 

Exercice 1 

Créez une base nommée voitures à l'aide de SQLiteManager. Créez ensuite les tables 
de la base voitures selon le modèle logique défini dans les exercices du chapitre 13 (en 
cas de problème, voir le corrigé des exercices de ce chapitre). Vérifiez la structure de 
chaque table. 
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Exercice 2 

Créez un formulaire permettant l'insertion des coordonnées d'une personne dans la table 
propretai re en utilisant la méthode objet. 

Exercice 3 

Insérez des données dans la table model e en utilisant SQLiteManager, puis créez un script 
qui affiche la liste de tous les modèles de voiture dans un tableau XHTML en effectuant 
un tri par marque. Utilisez la méthode procédurale. 

Exercice 4 

Adaptez le script de l'exercice 3 en utilisant la méthode objet. Les données de chaque 
ligne du résultat doivent aussi être retournées sous forme d'objet. 

Exercice 5 

Créez dynamiquement un formulaire contenant une liste de sélection XHTML (avec les 
éléments <select> et <option>) qui donne la liste de tous les modèles présents dans la 
table model e. Ajoutez manuellement à l'aide de SQLiteManager un ou plusieurs modèles à 
la table, et vérifiez que la liste de sélection prend bien en compte ces ajouts. Utilisez 
successivement la méthode procédurale et la méthode objet. 

Exercice 6 

Utilisez le mécanisme des transactions pour insérer simultanément et en toute sécurité 
des données dans les tables propriétaire et cartegrise. Utilisez la méthode procédurale 
puis la méthode objet. 

Exercice 7 

Créez un formulaire de recherche permettant de trouver toutes les personnes propriétai- 
res d'un modèle de véhicule donné. Affichez les résultats sous forme de tableau 
XHTML. Utilisez l'exercice 5 pour créer la liste de sélection des modèles. 

Exercice 8 

Reprendre les exercices précédents et les réécrire en utilisant systématiquement des objets 
PDO. 
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L'extension SimpleXML fut une des nouveautés importantes de PHP 5. Cette nouveauté 
n'est pas vraiment révolutionnaire puisque l'extension DOMXML permettait déjà d'accé- 
der au contenu d'un fichier XML à partir d'un script PHP. 

A la différence de DOMXML, SimpleXML apporte, comme son nom l'indique, un accès 
facile à toutes sortes de documents XML, même s'ils ont une structure complexe. Elle est 
encore dotée de peu de fonctions, mais elle ne tardera pas à s'enrichir au fur et à mesure 
des besoins manifestés par ses utilisateurs et la version 3 a déjà accru le nombre de 
commandes SQL disponibles. 

Les fonctions de SimpleXML retournent des objets qui possèdent des méthodes intéres- 
santes d'analyse des fichiers. Les fonctions et méthodes disponibles permettent de lire et 
de modifier le contenu des éléments ou des attributs d'un fichier XML, de sauvegarder 
ces modifications et d'effectuer des recherches sur les contenus. Cela représente déjà un 
large éventail d'activités. 

Notions de XML 

Le langage XML (eXtensible Markup Language) est un vecteur privilégié d'échange de 
données entre applications différentes. Comme l'illustre la figure 19-1, XML peut être 
le point commun d'applications qui ne pourraient pas communiquer entre elles sans son 
intermédiaire. 

A l'instar du XHTML, XML est un langage de structuration de contenu au moyen de 
balises. 
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Figure 19-1 

XML est un format d'échange entre applications 

Pour délimiter des éléments ayant un contenu explicite, XML utilise les structures géné- 
rales suivantes : 

I <balise> contenu de l'élément </balise> 

Pour les éléments n'ayant pas de contenu explicite (éléments vides), dans lesquels 
l'information est donnée uniquement dans un ou plusieurs attributs, il utilise les balises 
suivantes : 

I <balise attribut = "valeur"/> 

En XHTML, il existe 70 éléments prédéterminés. Les navigateurs implémentent ces 
éléments et associent à chacun d'eux un type de présentation de leur contenu. 

Par exemple, les lignes suivantes : 

I <hl> PHP5 MySQL </hl> 

écrivent dans un navigateur un gros titre suivi d'un saut de ligne, mais cette présentation 
peut être modifiée avec l'emploi de feuilles de styles CSS. 

DTD (Document Type Définition) 

Une DTD contient la description des éléments admis dans un document XHTML ou XML, comme le type 
d'un contenu et ses attributs. Pour être conforme, le document doit respecter ces définitions. Par exemple, 
l'élément <html > ne peut avoir comme éléments fils que les éléments <head> et <body> et comme attri- 
buts que xml ns, 1 ang et di r. 



L'objectif de XML est différent. Il consiste à décrire un grand nombre de types d'infor- 
mations différents, allant de la description des coordonnées d'un client jusqu'à celle 
d'une base de données complète, ce que ne permet pas le XHTML. 

L'idée essentielle à l'origine de XML est de structurer l'information en séparant le 
contenu de sa présentation, que ce soit dans un navigateur ou dans des médias les plus 
divers. Le contenu est écrit dans un fichier XML, et la présentation dans une feuille de 
style CSS ou XSLT. 
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Pour écrire un document XML, vous n'êtes plus limité par un nombre d'éléments fixe. 
Le créateur d'un document peut même choisir les noms des éléments qu'il souhaite utili- 
ser pour structurer ses informations. 

L'écriture d'un document XML doit obéir à des règles syntaxiques strictes afin d'être 
bien formé et lisible par un parseur XML, celui d'un navigateur pour ce qui nous 
concerne. 

Les principales règles syntaxiques de XML sont les suivantes : 

• Chaque document commence par l'élément suivant : 

I <? xml version = "1.0" encoding="IS0-8859-r' standalone = "yes"> 

dans lequel l'attribut version définit la version de XML utilisée. La dernière version 
publiée par le W3C est la 1.1, mais elle n'est actuellement pas bien reconnue par tous 
les navigateurs. L'attribut encoding contient le jeu de caractères utilisé dans le docu- 
ment. L'attribut standalone indique si le document est indépendant (valeur "yes") ou 
s'il doit faire appel à un autre document externe, comme une DTD, pour pouvoir être 
utilisé (valeur "no"). 

• Chaque document doit avoir un élément racine qui englobe tous les autres. C'est 
l'équivalent de l'élément <html > </html > dans un document XHTML. 

• Les noms des éléments sont écrits le plus souvent en minuscules. Les majuscules sont 
cependant autorisées, à condition que la balise d'ouverture ait la même casse que celle 
de fermeture. 

• Chaque élément ayant un contenu doit avoir une balise d'ouverture et une balise de 
fermeture, comme en XHTML selon la forme : 

I <element> contenu </element> 

• Les éléments n'ayant pas de contenu peuvent avoir la forme suivante : 
I <element /> 

• Chaque élément peut en contenir d'autres, sans limite de nombre. Les éléments qui en 
contiennent d'autres doivent être fermés après tous ceux qu'ils contiennent. On dit 
qu'ils doivent être correctement emboîtés. Leur structure doit respecter la forme géné- 
rale suivante : 

<element> 

<sousel einent> 
contenu du sous élément 

</sousel ement> 
</el ement> 

Vous obtenez une hiérarchie père -fils selon le modèle présenté à la figure 19-2. 

• Tous les éléments peuvent avoir des attributs contenus dans la balise d'ouverture. Les 
valeurs de ces attributs doivent être écrites entre guillemets : 

I <element attribut="valeur">contenu </element> 
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• Les caractères spéciaux suivants présents dans le contenu d'un élément doivent être 
remplacés par des entités prédéfinies : 

'<' par '<' 

'>' par '>' 

'&' par '&amp:' 

" par '"' 

' par '&apos;' 

La structure type d'un document XML est la suivante : 

<?xml version="1.0" encoding="iso-8859-l" standal one="yes"?> 
<racine > 
<elementl attribut="valeur"> 
<sousel ementA attribut="valeur">contenLi A</sousel ementA> 
<souselenientB attribut="valeur">contenLi B</sousel ementB> 
</elementl> 

<element2 attribut="valeur"> 

<sousel ementC attribut="valeur">contenu C</sousel ementO 

<sousel ementD attribut="valeur">contenu D</sousel ementD> 
</element2> 
</racine> 

En conséquence de la règle d'emboîtement des éléments, un document a une structure 
arborescente, comme illustré à la figure 19-2. 




Figure 19-2 

Structure arborescente d'un fichier XML 



Si vous ouvrez ce fichier dans un navigateur Firefox, vous obtenez un affichage sans 
grand intérêt pratique, comme le montre la figure 19-3. 

Dans le navigateur Amaya créé par le W3C, vous obtenez l'affichage du contenu des 
éléments sans les balises qui les délimitent ni leurs attributs, comme l'illustre la 
figure 19-4. 

Pour exploiter le contenu d'un fichier XML dans une page Web, il vous faut envisager les 
moyens de lire un fichier XML et de récupérer le contenu de ses éléments dans des varia- 
bles utilisables par des scripts PHP. 
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Ce fichier XML ne semble pas a\'oir d'infonnadon de st>1e associé a\'ec tui- L'arbre du document est 
montré ci-dessous. 


— <racine> 




— <elementl a ttribut=" valeur" > 




<souselemeotA attribut='\aIeur">contenu A< souselementA> 




<souselemeDtB attribut='\aleur">contenu B<'sonselementB> 




< elementl> 




— <element2 attribat="valeur"> 




<souselementC attribat='\aleur">contenu C<'souselementC> 




<souselementD attribnt="valeur">contenu D< souselementD> 




< element2> 




</racme> 





Figure 19-3 

Visualisation du fichier dans Firefox 
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contenu A 
contenu B 
contenu C 
contenu D| 






Text \ sousetementD \ e*ement2 \ racine ^ | 



Figure 19-4 

Visualisation du fichier dans Amaya 



Lecture d'un fichier XIVIL 

L'extension SimpleXML fournit des fonctions qui permettent un accès simple et rapide 
au contenu d'un fichier XML à l'aide d'objets de type siinplexml^element. Ces objets 
comportent des propriétés et des méthodes qui permettent d'accéder au contenu des 
éléments, de le modifier ou d'effectuer des recherches dans le fichier. 

Accéder au contenu d'un fichier XML 

Pour accéder au contenu d'un fichier XML, vous disposez de la fonction simplexnil_load_ 
fileO. 
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Cette fonction transfère le contenu du fichier dans un objet de type simplexml_element 
contenant l'arborescence du fichier. Les propriétés de cet objet prennent pour noms ceux 
de chacun des éléments XML et pour valeurs les contenus des éléments du fichier. 

La syntaxe de simpl exml_element est la suivante : 

I object simpl exml_loacl_file (string noni_fichier) 

Si l'ensemble du code XML est contenu dans une chaîne de caractères $code, vous 
pouvez utiliser la fonction suivante à la place de la précédente : 

I object siinplexml_load_string (string $code) 

Cette fonction retourne le même type d'objet. 

Un script de lecture de fichier XML commence donc par le code suivant : 

I $xml = simpl exml_load_file ( "nom_f ichier .xml " ) ; 

II est suivi de la lecture des données du fichier XML au moyen des propriétés et des 
méthodes de l'objet $xml de type simpl exml_element ainsi obtenu. 

Pour lire le contenu d'un élément nommé, par exemple, <1 ivre> vous écrivez : 

I echo $xml->livre; 

Le fichier XML bibl iol .xml suivant contient une bibliographie dont l'élément racine est 
<biblio> et dont les éléments <titre>, <auteur> et <date> contiennent les caractéristiques 
d'un seul livre. 

Le fichier bibliol.xml 

<?xml version="1.0" encoding="iso-8859-l"?> 
<biblio> 

<titre>L'empire de la honte</titre> 
<auteur>Jean Ziegler</auteur> 
<date>2005</date> 
</biblio> 

Le script de l'exemple 19-1 permet de lire le contenu du fichier bibliol.xml. Après 
le chargement du contenu du fichier dans l'objet $xml (repère O), le script affiche le 
contenu de chacun des éléments en utilisant les propriétés titre, auteur et date de l'objet 
$xml (repères 0, Q et O). 

'•^ Exemple 1 9-1 . Lecture des éléments 

<?php 

$xml =si mpl exml_l oad_f i 1 e( "bi bl i ol . xml " ) ; <— O 
echo "Titre :",$xml->titre,"<br />" <— 0: 
echo "Auteur :",$xml->auteur,"<br />" <— 0; 
echo "Date : " ,$xml ->date, "<br />" <— 

?> 
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L'exemple retourne le résultat suivant : 



Titre : L'empire de la honte 
Auteur : Jean Ziegler 
Date :2005 



Ce premier fichier bi bl i ol . xml est très simple et n'a pour but que d'introduire la méthode 
de lecture des éléments. Vous allez maintenant aborder la méthode de lecture d'un fichier 
XML plus proche d'un fichier réel. 

Le fichier bibl io2.xml contient encore une bibliographie, mais il est maintenant capable 
de contenir un nombre quelconque de livres. Pour cela, sa structure a été modifiée. 
L'élément racine <biblio> contient autant d'éléments <livre> que nécessaire, chaque 
livre étant encore caractérisé par les sous-éléments <titre>, <auteur> et <clate>. 

Le fichier biblio2.xiril 

<?xnil version=''1.0" encoding="iso-8859-l"?> 
<biblio> 
<1 ivre> 

<titre>L'empire de la honte</titre> 
<auteur>Jean Ziegler</auteur> 
<date>2005</date> 
</l ivre> 
<livre> 

<titre>Ritournell e de la faim </titre> 

<auteur>J.M.G Le Clézio</auteur> 

<date>2008</date> 
</l ivre> 
<1 ivre> 

<titre>Singue Sabour : La pierre de patience</titre> 
<auteur>Atiq Rahimi</auteur> 
<date>2008</date> 
</l ivre> 
</biblio> 

Pour accéder au contenu d'un élément <1 i vre>, vous devez utiliser une syntaxe proche de 
celle des tableaux. La variable $xml ->1 i vre[0] est maintenant un objet de type simpl exml_ 
élément. Cet objet représente le premier livre du fichier et possède autant de propriétés 
que l'élément <1 ivre> a de sous-éléments. 

Vous accédez aux informations utiles en écrivant le code suivant : 

echo $xml ->1 ivre[0]->titre: 
echo $xml ->1 ivre[0]->auteur; 
echo $xml ->1 ivre[0]->date; 



Ce code affiche le titre, l'auteur et la date de publication du premier livre. Pour lire 
l'ensemble des livres, il est préférable d'effectuer une boucle. 
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Le script de l'exemple 19-2 commence par charger le fichier biblio2.xml (repère O). Il 
lit ensuite l'ensemble du fichier avec le minimum de code en effectuant une boucle 
foreach sur l'objet $xml->livre (repère©). La variable $cle contient la même valeur 
livre à chaque itération. La variable $val est aussi un objet de type simplexml^element, 
dont les propriétés sont titre, auteur et date. Vous y accédez avec la même syntaxe qu'à 
l'exemple 19-1 (repère 0). L'utilisation du mot-clé static pour la variable compteur $i 
et son incrémentation permet d'afficher le numéro de chaque livre (repères 0 et 0). La 
figure 19-5 illustre le résultat obtenu. 



La fonction countQ 

La fonction get_object_vars($xml ) retourne un tableau de toutes les propriétés de l'objet $xml. En 
appliquant la fonction count( ) à ce tableau, vous obtenez le nombre de propriétés de l'objet. 



'•^ Exemple 19-2. Lecture d'un ensemble d'éléments 

<?php 

Sxml =simplexml_l oad_f i 1 e( "bibl io2 .xml " ) ; <— O 
//Lecture du contenu des éléments 
foreach($xml->livre as $cle=>$val ) <— 0 
{ 

static $i=l; <— 0 

echo ucf i rst($cl e) , " $i : $val->titre de $val->auteur paru en 
^$val->date<hr />"; <-© 
$i++: <— 0 

} 

?> 
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, Livre 1 


L'empire de la honte de Jean Ziegler paru en 2005 


Livre 2 


Ritouraelle de la faim de J.M.G Le Clézio paru en 2008 


Livre 3 


Singue Sabow : La pierre de patience de Atiq Rahimi paru en 2008 





Figure 19-5 

Affichage de tous les éléments du fichier biblio2.xml 
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Lecture des attributs d'un élément 

Chaque élément du document XML peut avoir des attributs. Les attributs constituent un 
complément d'information inclus dans un élément. Leur définition ressort d'un choix du 
programmeur, car la même information peut être enregistrée dans un sous-élément. Vous 
verrez que la transformation d'une base de données en fichier XML par phpMyAdmin ne 
crée aucun attribut et crée uniquement des éléments. Si ce choix de créer des éléments et 
des attributs est fait, il vous faut lire la valeur des différents attributs d'un élément. 

Le fichier XML biblio3.xml comporte les mêmes éléments que le fichier biblio2.xml, 
mais chaque élément <1 ivre> a désormais deux attributs, qui précisent l'éditeur et le prix 
de chaque livre. 

Le fichier biblio3.xml 

<?xml version="1.0" encoding="iso-8859-l" standalone="yes"?> 
<biblio> 

<livre éditeur^" FAYARD" prix="20.00"> 

<titre>L'empire de la honte</titre> 

<auteur>Jean Ziegler</auteur> 

<date>2005</date> 
</l ivre> 

<livre editeur="GALLIMARD" prix="18.00"> 

<titre>Ritournel 1 e de la faim </titre> 

<auteur>J.M.G Le Clézio</auteur> 

<date>2008</date> 
</l ivre> 

<livre editeur="POL" prix="15.00"> 

<titre>Singue Sabour : La pierre de patience</titre> 

<auteLir>Atiq Rahiini</auteur> 

<date>2008</date> 
</l ivre> 
</biblio> 

Les méthodes précédentes ne permettent pas la lecture de ces attributs. Pour parvenir à 
lire ces valeurs, vous disposez des deux possibilités suivantes : 

• Si vous connaissez le nom des attributs, vous pouvez lire leur valeur à l'aide de la 
syntaxe : 

ISxml ->livre[ "éditeur"] ; 
$xinl->livre["prix"]; 

• Si vous ne connaissez pas le nom des attributs ou si ces noms sont appelés à changer, 
vous avez intérêt à abstraire la lecture de leur nom et de la valeur associée en utilisant 
une méthode spécifique. Chaque objet de type simplexml_element possède en effet une 
méthode nommée attri butes ( ), qui retourne elle aussi un objet de même type. 
Comme précédemment, une boucle f oreach sur cet objet permet de récupérer le nom et 
la valeur de chaque attribut des différents éléments <1 ivre>. 
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Le script de l'exemple 19-3 réalise à la fois la lecture des éléments et celle des attributs. 
Après l'habituel chargement du fichier XML (repère 0)> une première boucle foreach, 
semblable à celle de l'exemple précédent, lit le contenu des éléments à l'aide des proprié- 
tés de l'objet $val (repère 0) et les affiche (repère 0). Une seconde boucle foreach 
imbriquée dans la première (repère Q) lit et affiche (repère 0) les propriétés de l'objet 
$val en récupérant le nom des attributs dans la variable $att et leur valeur dans la variable 
$valatt. 

Exemple 19-3. Lecture des éléments et des attributs 

<?php 

$xml =simplexnil_load_fi 1 eCbibl io3.xml " ) ; <— O 

//Lecture du contenu des éléments 
foreach($xml->livre as $val)<— 0 
{ 

echo "<h3>$val->titre de $val ->auteur</h3><b> Paru en $val->date </b> " : ^0 
//Lecture du nom et du contenu des attributs 
foreach($val ->attributes( ) as $att=>$val att) <— 0 
{ 

echo "<b> $att : Svalatt </b>":<-0 

} 

echo "<hr />"; 

} 

?> 

La mise en forme du contenu obtenue à l'aide d'éléments XHTML réalise l'affichage 
illustré à la figure 19-6. 

bcluer fcditioa âftichage tlistorique Marque-pages Uutils l 

• C ^ hHp:,'/localhoit/chapl9 /)(inB.php <Cj ~^ ||Ç1-| gocgiV fi\ 

L'empire de la honte de Jean Ztegler 
Paru en 2005 Editeur : FAYARD Prix : 20.00 



Ritournelle de la faim de J.M.G Le Clézio 
Paru en 2008 Editeur : GALLLVLVKD Prix : 18.00 



Singue Sabour : La pierre de patience de Atiq Rahimi 
Paru en 2008 Editeur : POI, Prix : 15.00 



Figure 19-6 

Affichage des éléments et des attributs 
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Lecture d'un fichier à structure complexe 

Les fichiers XML précédents ont tous une structure iiomogène et ne contiennent que la 
hiérarchie suivante répétée autant de fois que la bibliographie contient d'ouvrages : 

<livre> 

<titre> </titre> 

<auteur> </auteur> 

<clate> </date> 
</livre> 

Si le fichier contient divers éléments fils de l'élément racine, ces exemples ne permettent 
plus une lecture aisée du contenu des éléments. Le fichier bibl io4.xml présente un type 
de structure complexe contenant un élément <ouvrage> (repère O) qui contient des 
éléments <livre> comme précédemment. En plus, un élément <musique> (repère©) 
contient des éléments <clisque>, qui contiennent à leur tour des éléments <titre>, <auteur> 
et <date>. Chaque grande catégorie (ouvrage et musique) est donc constituée de trois 
niveaux d'éléments imbriqués. 

Le fichier biblio4.xml 

<?xml version="1.0" encoding="iso-8859-l" standalone="yes"?> 
<biblio> 
<ouvrage> <— O 
<livre editeur="FAYARD" prix="20.00"> 
<titre>L' empi re de la honte</titre> 
<auteur>Jean Ziegler</auteur> 
<date>2005</date> 
</l ivre> 

<livre editeur="GALLIMARD " prix="18.00"> 

<titre>Ritournel 1 e de la faim </titre> 

<auteur>J.M.G Le Clézio</auteur> 

<date>2008</date> 
</l ivre> 

<livre editeur="POL" prix="15.00"> 
<titre>Singue Sabour : La pierre de patience</titre> 
<auteur>Atiq Rahiini</auteur> 
<date>2008</date> 
</l ivre> 
</ouvrage> 
<musique> <— © 
<disqLie editeur="Deutsche Grammophon" Prix="14.00"> 
<titre>5 eme Symphonie </titre> 
<auteur>Ludwig van BEETHOVEN</auteLir> 
<date>1808</date> 
</di sque> 

<d1sque editeur="EMI" Prix="14.00"> 

<titre>Suites pour violoncelle </titre> 

<auteur>Johann Sébastian BACH</auteur> 

<date>1725</date> 
</di sque> 
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I</musique> 
</biblio> 

Pour lire le contenu de ces deux catégories, vous disposez de la méthode childrenO de 
l'objet $xml de type simplextnl_eleinent retourné par la fonction simplexml_load_file() 
de chargement du fichier XML. Chaque fois qu'elle est appliquée, elle retourne un objet 
de type simplexml_element contenant tous les sous-éléments de même niveau situés dans 
le document, et donc tous les enfants du nœud précédent. 

Un premier appel (repère O) retourne les éléments <ouvrage> et <musique>, donc tous les 
enfants de l'élément racine <biblio>. Un deuxième appel appliqué à ces éléments 
retourne ceux qu'ils contiennent, et ainsi de suite (repères Q et 0). 

Sur ce principe, l'exemple 19-4 permet la lecture des trois niveaux de chaque catégorie à 
l'aide de trois boucles foreach imbriquées l'une dans l'autre. Le code des deux boucles 
les plus internes est identique. En imbriquant une quatrième boucle, vous pourriez lire 
quatre niveaux d'éléments imbriqués. 

Exemple 19-4. Lecture d'une hiérarchie d'éléments complexe 

<?php 

$xml =simplexml_l oad_f i 1 e( "bibl io4.xml " ) ; 
foreach($xnil->children() as $el einent=>$val ) <— O 
{ 

echo "<h3>". ucfirst($element) .": $val</h3>": 
foreach($val ->chi ldren( ) as $element=>$val ) <— 0 
{ 

echo " $element : <b>$val</b><br />"; 
foreach($val->children() as $el ement=>$val ) <— 0 

{ 

echo "&nbsp:  Selement : <b>$val</b><br />"; 

} 

} 

} 

?> 

La figure 19-7 illustre le résultat du script de lecture du fichier. 

Modification des valeurs des éléments et des attributs 

En utilisant les propriétés de l'objet de type simplexml_element retourné par la fonction 
simplexml_load_f ile( ), un script peut modifier la valeur du contenu d'un élément ou d'un 
attribut. Il suffit pour cela d'utiliser la notation objet qui permet de lire une propriété et de 
lui affecter une nouvelle valeur. L'exemple 19-5 réalise ces modifications et enregistre le 
fichier modifié sur le serveur. 

Pour modifier, par exemple, les caractéristiques du premier livre du fichier biblioS.xml, 
vous pouvez écrire le code de l'exemple 19-5. Il commence par charger le fichier dans 
l'objet $xml (repère O) puis change le titre et la date du premier élément <1 ivre> (repè- 
res 0 et 0). 
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livre : 

titre : L'empire de la honte 
auteur : Jean Ziegler 
date : 2005 
livre : 

titre : Ritonmelle de la faim 
auteur : J.M.G Le Clézio 
date : 2008 
liwe : 

titre : Singne Saboor : La pierre de patience 
auteur : Atiq Rahimi 
date : 2008 

Musique: 

disque : 

titre : 3 eme Symphonie 

auteur : Ludwig van BEETHOVEN 

date : 1808 
disque : 

titre ; Suites pour violoncelle 

auteur : Johann Sébastian BACH 

date ; 1725 



Figure 19-7 

Lecture du fichier à structure complexe 



A ce stade, les données sont censées être modifiées dans l'objet $xml . Si vous le vérifiez 
en effectuant une boucle de lecture (repère ©), vous constatez que le fichier XML n'est 
pas modifié. La raison à cela est que les modifications n'ont pas été enregistrées. Pour 
enregistrer les modifications, vous appelez la méthode asxmlO des objets simplexml_ 
el ement, dont la syntaxe est la suivante : 

I string $xml ->asxml ( [string noin_fichier]) 

Cette méthode retourne le contenu de l'objet $xml dans une chaîne de caractères $chxml 
(ou FALSE en cas d'erreur). Utilisée avec comme paramètre un nom de fichier (ici 
bibl io3a .xml afin de ne pas écraser l'ancien fichier), la méthode enregistre également le 
fichier sur le serveur (repère 0). Un contrôle sur la valeur de la variable Schxml permet 
d'afficher un message de confirmation (repère ©). 
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'■^ Exemple 19-5. Modification et enregistrement des données 

<?php 

$xml =simplexml_load_f i 1 e( "bibl ioS.xml " ) ; <— O 
//Modification d'un élément et d'un attribut 
$xml->livre[0]->titre="La haine de l'Occident " ; <— 0 
$xml ->1 i vre[0]->date=''2008" ; ^© 
//Affichage des données du fichier 
foreach($xml->livre as $cle=>$val ) <— O 
{ 

static $i=l: 

echo ucf 1 rst($cl e) , " $i : $val->titre de $val->auteur paru en $val ->date<hr />"; 
$i++: 

} 

//Enregistrement des modifications 
$chxml= $xrtil ->asxnil ( "bibl io3a.xml " ) ; <— © 
if($chxml) echo "Enregistrement réalisé"; <—© 
?> 

Après l'exécution du script de l'exemple 19-5, le premier élément <livre> du fichier 
XML est le suivant : 



<livre editeur="FAYARD" prix="20.00"> 

<titre>La haine de l'Occident </titre> 
<auteur>Jean Ziegler</auteur> 
<date>20G8</date> 

</l ivre> 



Recherche dans un fichier 

L'extension SimpleXML permet d'effectuer des recherches dans un fichier XML grâce à 
la méthode xpathO des objets de type simplexml_element. 

La syntaxe de la méthode xpath( ) est la suivante : 

I array xpath(string requete_xpath) 

La fonction retourne un tableau de tous les contenus d'éléments ou d'attributs qui corres- 
pondent à la requête qui lui est passée en paramètre. Pour effectuer une recherche, vous 
devez décrire l'arborescence permettant de parvenir à l'information recherchée. 

Considérant que vous effectuez des recherches de titres, d'auteurs et d'éditeurs dans le 
fichier bi bl i o4 . xml , vous pouvez écrire les exemples de requêtes suivants : 

• Pour trouver tous les titres de livre (seuls les éléments fils de l'élément <1 i vre> ont un 
contenu textuel dans le fichier) : 

$xnil ->xpath( "/bibl io/ouvrage/1 ivre/titre") ; 
$xnil ->xpath( "//ouvrage/1 ivre/titre" ) ; 
$xnil ->xpath( "//l ivre/titre" ) ; 

• Pour trouver les auteurs, vous remplacez titre par auteur. Faites de même pour les dates. 
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• Pour trouver tous les titres de disque : 

|$xml ->xpath( "/bibl io/musique/di sque/titre" ) ; 
$xml ->xpath( "//musique/disque/titre" ) ; 
$xinl ->xpath( "//disque/titre" ) ; 

• De même que précédemment, pour trouver tous les compositeurs, vous remplacez 
titre par auteur. Faites de même pour les dates. 

• Pour trouver tous les titres ou les auteurs, qu'ils soient dans la catégorie ouvrage ou 
musique, vous écrivez : 

ISxiTil ->xpath( "//titre" ) ; 
$xinl ->xpath( "//auteur" ) ; 

• Pour trouver la valeur d'un attribut, vous écrivez le nom de l'attribut à la place de celui 
de l'élément, en le faisant précéder du caractère @. Par exemple, pour trouver tous les 
attributs éditeur des éléments <livre>, vous écrivez : 

ISxml ->xpath( "/bibl io/ouvrage/1 i vre/@edi teur" ) ; 
$xinl ->xpath( "//ouvrage/ 1 i vre/@editeur" ) ; 
$xml ->xpath( "//l i vre/@editeur" ) ; 

• Pour trouver toutes les valeurs des attributs éditeur, qu'ils soient ceux des éléments 
<livre> ou <disque>, vous écrivez : 

I Sxinl ->xpath( "//©éditeur" ) : 



XPath 

XPath est un langage puissant permettant la création de requêtes. Nous ne nous étendons pas ici sur la 
composition des requêtes XPath, mais vous pouvez consulter à ce sujet la recommandation du W3C sur 
le site http://www.w3.org/TR/xpath. 



Les résultats de ces recherches étant retournés dans un tableau indicé, vous pouvez utili- 
ser une boucle for ou foreach pour les lire. 

L'exemple 19-6 propose une illustration du mécanisme de recherche utilisant la méthode 
xpath( ). Le fichier est composé d'une partie XHTML, qui crée le formulaire comprenant 
deux listes de sélection nommées choix (repère O) et cat (repère©), avec lesquelles 
l'utilisateur peut choisir respectivement le contenu qu'il désire (titre, auteur ou éditeur) et 
la catégorie (ouvrage, musique ou les deux à la fois). La valeur associée à chaque option 
servira à composer la chaîne de la requête XPath. Ces valeurs sont récupérées par le 
script dans les variables $_POST[ 'choix' ] et $„POST[cat'] (repères ©et©). 

Après le chargement du fichier biblio4.xml (repère©), l'objet $xml appelle la méthode 
xpathO, dont la chaîne de requête est la concaténation de deux variables, $cat et 
$choix, les résultats étant retournés dans le tableau Sresult (repère ©). L'élimination 
des doublons s'effectue en appliquant la fonction array_unique( ) au tableau $result 
(repère©). L'utilisation d'une boucle foreach permet l'affichage de tous les résultats 
sous forme de liste ordonnée (repère ©). 
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La figure 19-8 illustre les résultats obtenus après une recherche de tous les titres de la caté- 
gorie ouvrage, la chaîne de requête étant alors la concaténation des chaînes //ouvrage/ 
1 ivre/ et titre. 

'•^ Exemple 19-6. Recherche dans un fichier XIVIL 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html ; charset=i so-8859-1" /> 

<title>Bibliographie XML</title> 

</head> 

<body> 

<forni action^ "<?php echo $_SERVER[ ' PHP_SELF' ] ?>" method="post" 
^enctype="appl ication/x-www-form-url encoded"> 
<f iel dset> 

<1 egend><b>Bibl iographie</b></legend> 

<table><tbody> 

<tr> 

<td>Rechercher tous les : </td> 
<td> 

<select name="choix"> <— O 

<option val ue="ti tre">Ti tre</option> 

<option val ue=" auteur ">Auteur</option> 

<option val ue="@edi teur">Edi teur</option> 

</select> 

</td> 

<td>Dans les catégories 
<select name="cat"> <— 0 

<option value="//ouvrage/livre/"> Ouvrages </option> 
<option value="//musique/disque/"> Musique </option> 
<option val ue="//">Toutes </option> 
</sel ect> 

<input type="submit" name="envoi" value="OK"/> 

</td> 

</tr> 

</tbody></table> 

</fieldset> 

</form> 

<P> 

<a href="http: //val idator.w3.org/check?uri=referer"><img 
s rc="http: //www. w3.org/Icons/ val id-xhtml 11" 
alt="Valid XHTML 1.1" height="31" width="88" /></a> 

</p> 
<?php 

if(isset($_POST['envoi '])) 
{ 

$choix= $_POST[ 'choix' ]; <—© 
$cat= $_POST['cat']; <-© 
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$xml=simpl exnil_load_f i 1 e( "bibl io4.xml " ) ; <—Q 

$result= $xml->xpath($cat.$choix); <— © 

//Éliminer les doublons 

$resul t=array_uni que ($ resuit) ; <— © 

echo "<h3>Résultats de la recherche</h3>" ; 

//Affichage sous forme de liste 

echo "<div><ol>"; 

foreach($result as Svaleur) <— 0 

{ 

echo "<li><big>$valeur </big></li>"; 

} 

echo "</ol></div>"; 

} 

?> 

</body> 
</html> 



illographie XML - Mozïlla Fîrefoit 



Fichier Édition Affichage Historique Marque-pages Outils ? 

ir 



http://www.funhtml.com/php5/C19/xml6.php "{J 



" Bibliographie 

Rechercher tous les : Titre » Dans les catégories Ouvrages ▼ | OK | 



Résultats de la recherche 

1. L'empire de la honte 

2. Ritournelle de la faim 

3. Singue Sabour : La pierre de patience 



Figure 19-8 

Résultats de la recherche des titres dans le fichier XML 



Création d'un fichier XIVIL à partir d'un formulaire 

Il est possible de créer un fichier XML à partir des données saisies dans un formulaire, 
comme vous l'avez déjà réalisé dans un fichier texte ou dans une base de données 
MySQL. Vous verrez dans la section suivante qu'il est aussi possible de transférer des 
données d'une table de base de données dans un fichier XML et même de réaliser 
l'opération inverse. 

L'exemple 19-7 crée une bibliographie en ligne, qui sera enregistrée dans un fichier 
XML à partir des données saisies dans un formulaire. Ce formulaire contient trois 
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champs de type texte, dans lesquels un visiteur peut indiquer le titre, l'auteur et la date de 
parution de l'ouvrage qu'il souhaite ajouter à la bibliographie. Celle-ci peut s'enrichir 
des choix de chaque visiteur. Les scripts utilisés précédemment permettent ensuite l'affi- 
chage de l'ensemble des livres. 

Le script commence par créer un formulaire classique de saisie. La partie de code PHP 
qui se situe dans le même fichier que le code XHTML vérifie d'abord l'envoi du formu- 
laire et si les champs texte sont bien complétés (repère Q)- Les valeurs de ces champs 
sont ensuite récupérées dans les variables $titre, Sauteur et Sdate. Les caractères 
spéciaux XML sont transformés en entités de caractères en utilisant la fonction html - 
speci al chars ( ) (repères ©, © et©). 

Si le fichier bi bl i 06 . xml qui va contenir les données n'existe pas encore (repère 0), vous 
l'écrivez dans la variable Schxml . L'élément racine se nomme <bi bl i o> et contient un seul 
élément <livre> (repère ©). S'il existe, son contenu est récupéré dans la variable objet 
$xml (repère Q) et transféré dans la variable chaîne de caractères Schxml en appelant la 
méthode asxml ( ) (repère 0). 

Il vous faut à ce stade supprimer la balise de fermeture </bi bl i o> en utilisant la fonction 
str_replace{), qui la remplace par une chaîne vide dans la variable $chxml (repère©). 
Vous pouvez concaténer les nouvelles données avec les anciennes et ajouter la balise 
</biblio> afin que le document XML soit bien formé (repère ©)• H ne reste plus qu'à 
enregistrer le contenu de la chaîne $chxml dans le fichier biblio6.xml à l'aide de la fonc- 
tion file„put_contents( ) (repère ©). 

Exemple 19-7. Enregistrement des données d'un formulaire au format XML 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www. w3.org/1999/xhtml" xml :lang="fr"> 
<head> 

<meta http-equiv="content-type" content="text/html : charset=i so-8859-r' /> 

<title>Enregistrement en XML</title> 

</head> 

<body> 

<form action^ "<? $_SERVER['PHP_SELF'] ?>" method="post" 
^enctype="appl ication/x-www-form-url encoded"> 
<fieldset> 

<legend><b>Saisie de données</b></legend> 

<table><tbody> 

<tr> 

<td>Titre : 
<input type="text" name="titre" /> 

</td> 
</tr> 
<tr> 

<td>Auteur : 

<input type="text" name="auteur" /> 
</td> 
</tr> 
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<tr> 

<tcl> Date : 
<input type="text" name="date" /> 

</td> 
</tr> 
<tr> 
<td> 

<input type="subniit" naine="envoi " value="OK"/> 

</td> 

</tr> 

</tbody></table> 

</fieldset> 

</form> 
</body> 
</html> 

<?php 

if(i sset($_POST[' envoi '])&& !ertipty($_POST['titre'])&& !einpty($_POST[' auteur '])&& 

'•!empty($_POST['date'])) <-© 

{ 

$titre= htnilspecialchars($_POST['titre']): <— © 
$auteur= html spécial chars($_POST[ 'auteur ']) ; <— © 
$date= htmlspecialchars($_POST['date']); <— O 
ifdfile.existsCbiblioB.xml")) <— 0 
{ 

$chxml= "<?xinl version=\"l .OV" encoding=\''iso-8859-l\''standalone=\"yes\''?> 
^\n<bibl io>\n <livre>\n <titre>$titre</titre>\n <auteur>$auteur</auteur> 
^\n <date>$date</date>\n</livre>\n</biblio>"; <— 0 

) 

el se 
{ 

$xml=simpl exnil_load_f i 1 e( "bibl ioB.xml " ) ; <— © 
$chxml = $xml ->asxml ( ) ; <— 0 

$chxml = str_repl ace( "</bibl io)" . "", $chxinl);<— 0 

$chxml.= "<livre>\n <titre>$titre</titre>\n <auteur>$auteur</auteur>\n 

*<date>$date</date>\n</livre>\n</biblio>": <— © 

) 

$veri f=f i 1 e_put_contents( "bibl io6.xinl " ,$chxinl ) ; <— 0 

1 

?> 



Relations entre XML et une base MySQL 

Les fichiers XML étant lisibles par de nombreux médias, ils constituent un excellent 
moyen d'échange de données entre différents systèmes. En particulier, vous allez les 
utiliser pour stocker les données d'une table MySQL dans un format structuré. Cela vous 
permettra de les transmettre à d'autres applications, qui seraient incapables d'accéder 
directement aux données d'une base MySQL. Vous verrez également les moyens permet- 
tant de réaliser l'opération inverse. 
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Fichier Édition Affichage Historique j|^fqiie-pages Outils ? 

|— Saisie de données 



^ ( l_i i httpî//www.funhtinl.conn/php5/C19/xmt7.php '(2? ' | ||G]' 



Tili c : XHTMLetCSS 



Auteur : Jean Engels 
Date : 2006 ^ 



OK 



Figure 19-9 

Formulaire de saisie des données à enregistrer au format XML 



Création d'un fichier XML à partir d'une table D/lySQL 

Différentes méthodes pennettent de transférer les données d'une table MySQL dans un 
fichier XML. Ce dernier est alors utilisable par toutes sortes d'applications, incluant 
PHP, JSPetASP.Net. 



Utilisation de phpIVIyAdmin 

La méthode la plus simple et la plus rapide pour créer un fichier XML à partir d'une base 
de données consiste à utiliser phpMyAdmin. Cette interface est dotée d'un script, qui 
réalise cette opération automatiquement. La structure du fichier XML créé a une struc- 
ture bien déterminée, qui ne correspond pas nécessairement aux désirs du programmeur. 

Les règles de transformation appliquées par ce script sont les suivantes : 

• Le nom de la base devient l'élément racine du document XML. 

• Le nom de la ou des tables devient un élément de premier niveau. Il y a donc autant 
d'éléments de ce type que de lignes dans la table MySQL. 

• Le nom de chaque colonne de la table devient celui d'un élément imbriqué dans le 
précédent, dont le contenu est la valeur du champ de la table. 

• Aucun attribut n'est créé. 

Plus généralement, si vous exportez une base entière comportant plusieurs tables, la 
structure du fichier XML résultant est de la forme de l'exemple 19-8. Ce dernier est le 
résultat de l'exportation de la base magasin utilisée aux chapitres 14 et 15. 

Les étapes pour exporter cette base en utilisant l'interface phpMyAdmin sont les suivantes : 

1 . Choisissez la base dans la liste de sélection. 

2. Cliquez sur le bouton Exporter. 

3. Sélectionnez la ou les tables désirées. 
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4. Cliquez sur le bouton radio XML. 

5. Cochez la case Transmettre. 

En principe, une boîte de dialogue apparaît, vous invitant à enregistrer le fichier sur le 
poste. Cela ne fonctionne toutefois que si vous choisissez la compression zippé ou gzippé. 
Si vous ne choisissez aucune compression, le fichier XML s'affiche dans son intégralité. 
Vous pouvez le sauvegarder avec l'extension .xml en cliquant sur la fenêtre qui contient 
le code et en sélectionnant Fichier, Enregistrer sous. Nom de fichier et Type .xml. 

La figure 19-10 présente la page de l'utilitaire phpMyAdmin qui permet l'exportation 
des données au format XML. 
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Figure 19-10 

Exportation de la table article au format XML avec phpMyAdmin 



Exemple 19-8. Le fichier magasin.xml 

<?xnil version="1.0" encoding="utf-8" ?> 
<!-- 



phpMyAdmin XML Dump 

version 3.0.1.1 

http : //www . phpmyadmi n . net 



- Serveur: localhost 



- Généré le : Mer 17 Décembre 2008 à 21:52 

- Version du serveur: 5.1.30 

- Version de PHP: 5.2.7 
— > 

<! — 

- Base de données: 'magasin' 

— > 

<iiiagasin> 

<!-- Table article --> 
<article> 

<id_article>CS330</id_article> 

<designation>Caméscope Sony DCR-PC330</designation> 
<prix>1629.00</prix> 
<categorie>vidéo</categorie> 
</article> 
<!-Suite de la table article 

--> 

<!-- Table client --> 
<cl 1ent> 

<id_cl ient>l</1d_cl ient> 
<nom>Marti</nom> 
<prenom>Jean</prenoni> 
<age>36</age> 

<adresse>5 Av Einstein</adresse> 
<vil 1 e>0rl éans</vil 1 e> 
<mail>mart@marti .coin</mail> 
</cl ient> 

<!-Suite de la table client 
--> 

<!-- Table commande --> 
<commande> 

< i d_comm> 1 < / i d_comm> 

<id_cl ient>5</id_cl ient> 

<date>2004-06-ll</date> 
</commande> 

<!-Suite de la table commande 
--> 

<!-- Table ligne --> 
<ligne> 

<id_comm>l</id_comm> 

<id_article>CS330</id_article> 

<quanti te>l</quanti te> 

<prixunit>1629.00</prixunit> 
</l igne> 

<!-Suite de la table ligne 

--> 

</magasin> 
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Utilisation d'un script PIHP 

L'inconvénient de la méthode précédente est que le structure du fichier XML créé par le 
script de phpMyAdmin est déterminée par avance et qu'elle ne définit aucun attribut. Si, 
pour une raison quelconque d'organisation, vous souhaitez que certaines colonnes d'une 
table deviennent des attributs ou une autre structure particulière, il vous faut écrire un 
script personnalisé qui créé par un fichier XML approprié. 

L'exemple 19-9 en donne une illustration en créant un fichier XML nommé article. xml, 
contenant les données de la table article de la base magasin créée et utilisée à plusieurs 
reprises dans l'ouvrage. 

La structure choisie pour l'exportation des données est la suivante : 

<article id="CS330" categorie="vidéo"> 

<clesignation>Cainéscope Sony DCR-PC330 </designation> 

<prix>1629.00 </prix> 
</article> 

L'élément <article> contient les informations sur les quatre colonnes de la table article 
mais dans une organisation différente. La clé primaire id_article de la table devient 
l'identifiant unique de l'élément <article>, et la colonne catégorie un attribut de cet 
élément. Les sous-éléments <designation> et <prix> correspondent aux colonnes de 
même nom dans la table. 

Comme vous devez accéder à la base magasin, le script commence par inclure la fonction 
de connexion (repère O). Il établit ensuite la connexion au serveur MySQL et récupère 
l'identifiant de connexion dans la variable Sidcom (repère ©). La requête SQL est très 
simple puisque vous souhaitez lire toutes les colonnes de la table (repère 0). Après envoi 
de la requête (repère Q), l'ensemble des résultats est accessible au moyen de la variable 
$result. Vous créez alors une variable $chxml contenant la déclaration XML et l'élément 
racine <magasin> (repère 0). 

Une boucle whi 1 e de lecture des résultats récupère chaque ligne dans un tableau associatif 
(repère ©) et concatène les différents éléments à la chaîne $chxml (repères 0, 0, 0 et 
©). La balise de fermeture de l'élément racine </magasin> est finalement ajoutée à la 
chaîne du code XML (repère©), qui est enregistrée dans le fichier article. xml 
(repère ®). 

Exemple 19-9. Transfert de données d'une table dans un fichier XML 

<?php 

incl ude( "connex. inc.php" ) ; <— 0 
$idcom=connex( "magasin" , "myparam" ) ; <— 0 
$requete="SELECT * FROM article": <-0 
$result=mysql_query($reqLiete, Sidcom) ; <— O 

$chxml ="<?xml version=\"1.0\" encoding=\"iso-8859-l\" standalone=\"yes\"?> 
^\n<magasin>" ; <— 0 

while($ligne=mysql_fetch_array($result.MYSQL_ASSOC)) <— 0 
{ 
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$chxml .="<article id=\"{$ligne['id_article']}\" categorie=\"{$ligne[' catégorie']} 
^\">\n"; 

Schxml .=" <designation>{$ligne['designation']} </designation>\n" ; <— 0 
$chxn)l.='' <prix>{$ligne['prix']) </prix>\n" ; <— © 
$chxml.= "</article>\n''; <— ® 

} 

$chxml . = "</magasin>" ; <— © 
fil e_put_contents( "article. xiTil " ,$chxinl ) ; <— ® 
?> 

La figure 19-1 1 présente une partie du fichier XML créé par ce script. 



3 C:\Program Files\wampser\ferWww\php5\C1 7xnnl\article.xrnl - Microsoft Internet Explorer 


0@®| 


Fichier Edition Affichage Favoris Outils ? 


m 


Précédente ' >^ [x] ^w] ^ Rechercher *^ Favoris Média ^ 


Adresse [@ C:\Program Files\wampserver\www\php5\C17xml\article,xml 





<?xml version="l,0" encodrng="iso-8859-l" standalone="yes" ?> 
■ <magasin> 

- <article id="CS330" categorie="vidéo"> 

<designâtion>Caméscope Sony DCR-PC330</designation> 

< prix > 1629. 00</pnx> 
</artide> 

- <article id="NIK55" categorie="photo" > 

<designation>Nikon F55+zoom 28/80</designation> 
<prix>269.00</prix> 

</articie> 

- <article id="NIK80" categorie="photo"> 

< désignation >Nikon F80</designatjon> 
<prix>479.00</prix> 

</article> 

- <article id="SOXMP" categorie="inforniatique"> 

<designation>PC Portable Sony Zl-XMP</designation> 
<prix>2399,00</pnx> 

</ârticle> 

- <article id="HP497" categorie="informatique"> 

<designation>PC Bureau HP497 écran TFT</designation> 

< prix >1 500. 00</phx> 
</article> 

- <article id="DVD75" categorie="divers"> 

<designation>DVD vierge par 3</designation> 
<prix>17.50</pnx> 
</article> 

- <article id="CAS07" câtegorie="divers"> 

<designation>Cassette DV60 par 5</designation> 
<prix>26.90</prix> 
</ârticle> 

- <article id="DEL30" categorie="informatique"> 

<designation>Portable Dell X300</designation> 
<prix>171S.00</prix> 

</article> 

- <article id="CP100" categorie="vidéo" > 

<designation>Caméscope Panasonic SV-AV 100</designation> 

< prix >1 490. 00</prix> 
</article> 

- <article id="SAX15" categone="informatique"> 

<designation>Portable Samsung X15 XVM</designation> 

< prix >1 999. 00</pnx> 
< /flrtinlp > 



I 



@ Terminé 



9 Poste de travail 



Figure 19-11 

Le fichier arîicie.xml visualisé dans Internet Explorer 
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Création d'une table MySQL à partir d'un fichier XML 

Vous pouvez maintenant réaliser l'opération inverse en insérant dans une table d'une 
base MySQL les données d'un fichier XML en provenance d'une source quelconque. La 
structure de ce fichier doit être connue pour permettre de créer à l'avance la table desti- 
née à recevoir les données. 

Dans l'exemple 19-11, vous récupérez les données d'un fichier XML ayant une structure 
identique à celle du fichier biblioS.xml utilisé précédemment. L'élément racine se 
nommait <bi bl i o> et son contenu était de la forme suivante : 

<livre editeur="FAYARD" prix="20.00"> 

<titre>L' empi re de la honte</titre> 

<auteur>Jean Ziegler</auteur> 

<date>2005</date> 
</livre> 

Les étapes nécessaires sont les suivantes : 

• Création d'une base nommée biblio si le serveur admet plusieurs bases. Dans le cas 
contraire, l'étape suivante suffit. 

• Création d'une table nommée livre contenant six colonnes, cinq correspondant aux 
valeurs contenues dans un élément <livre> plus un indispensable identifiant numéri- 
que entier auto-incrémenté. Ce dernier sera la clé primaire de la table de façon à ne pas 
déroger aux règles énoncées au chapitre 13. 

Pour les détails de création d'une base et d'une table, reportez-vous au chapitre 14. 
Le code de l'exemple 19-10 donne la commande SQL de création de la table livre. 
La figure 19-12 illustre la structure affichée par phpMyAdmin. 

Exemple 19-10. Code SQL de création de la table livre 

CREATE TABLE ~livre~ ( 

~idlivre~ sinallint(5) unsigned NOT NULL auto_1ncrement, 

~ed1teur~ varchar(20) NOT NULL default ", 

~pr1x~ décimal (4.2) unsigned NOT NULL default '0.00', 

~titre~ varchar(40) NOT NULL default ". 

"auteur" varcharOO) NOT NULL default ", 

"date" year(4) NOT NULL default '0000', 

PRIMARY KEY ("idlivre") 

) 

Afin d'opérer ce transfert de données, vous commencez par récupérer le contenu du 
fichier biblio3.xrtil dans la variable objet $xml (repère O). La connexion au serveur 
MySQL est réalisée comme aux chapitres précédents par la fonction connex( ), dont vous 
devez inclure le code (repère ©) avant d'effectuer la connexion (repère 0). Vous lisez 
avec countC ) le nombre d'éléments <1 ivre> présents dans le document XML en comptant 
le nombre d'éléments du tableau retourné par $xml->livre (repère ©). Ce nombre est 
utilisé par un boucle for (repère 0), qui lit l'ensemble des attributs éditeur et prix des 
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éléments <livre> (repères Q et et le contenu des sous-éléments <titre>, <auteur> et 
<clate> (repères 0, Q et ®)- 



Champ 


Type 


Attributs 


Hull Défaut 


Extra 


idiivre 


smallint(5) 


UNSIGNED 


Non 




autojncrement 


éditeur 


varchar(20) 




Non 






prix 


decimal(4,2) UNSIGNED 


Non 


0.00 




titre 


varchar(40) 




Non 






auteur 


varchar(30) 




Non 






date 


year(4) 




Non 


0000 





Figure 19-12 

Structure de la table livre 

La requête d'insertion des données dans la table 1 i vre est écrite dans la variable $requete 
(repère ®) puis soumise au serveur (repère ®). Une vérification est opérée pour s'assu- 
rer que les données sont insérées dans la table (repère ©). 

Exemple 19-11. Transfert de données XML dans une table 

<?php 

$xml =si mpl exml_l oacl_f i 1 e( "bi bl i o3 . xml " ) ; <— O 

//Connexion à la base 

incl ucle_once("connex.inc.php" ) ; <— 0 

$idcom= connex("biblio","myparam"); <— 0 

//Lecture du contenu des éléments 

$nblivre= count($xirl ->1 i vre) ; <— O 

echo "Nombre de livres : ",$nblivre,"<br />"; 

for($i=0:$i<$nblivre:$i++) <— 0 

{ 

$editeur=$xml ->1 ivre[$i ][@editeur] ; <— 0 
$prix=$xml ->1 ivre[$i ][@prix] ; <— 0 
$titre=htmlentities($xml ->livre[$i]->titre) ; <— 0 
$auteur=$xml ->1 i vre[$i ]->auteur; <— 0 
$date=$xml->livre[$i]->date; <— © 
//Requête SQL 

$requete= "INSERT INTO 1 ivre(idl ivre, éditeur, prix, titre, auteur, date) 
^VALUES( '\N' , '$editeur' . '$prix' , '$titre' , 'Sauteur' , '$date' )" ; <-0 
//Envoi de la requête d'insertion 
$verif=mysql_query($requete,$idcom) ; <— ® 

if($verif) echo "<br /> Stitre inséré dans la base<hr />";<—© 

} 

?> 



Mémo des fonctions et méthodes 
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object siiiiplexml_import_dom(nodedom node) 

Crée un objet simpl exinl_el ement à partir d'un objet DOM. 

object simplexml_load_file(string noin_fictn'er) 

Transfère le contenu d'un fichier XIVIL dans un objet de type simpl exml_el ement. 

object simplexml_load_string(stn'ng chaine_xml) 

Transfère un contenu XIVIL d'une chaîne de caractères dans un objet de type simpl exml_el ement. 
string asxml ([string ncm_fichier]) 

Transfère le contenu d'un objet de type simpl exml_el ement dans une chaîne. Si vous fournissez un paramètre, la 
méthode enregistre le fichier sur le serveur. 

object attributesO 

Retourne un objet dont les propriétés sont les attributs de l'objet simpl exml_el ement auquel vous appliquez la méthode. 

object children( ) 

Retourne un objet dont les propriétés sont les éléments enfants de l'élément auquel vous appliquez la méthode, 
array xpath(string requete_patti) 

Effectue une requête XPath sur les données de l'objet auquel vous appliquez la méthode. 



Exercices 

Exercice 1 

Créez un fichier XML nommé iut.xml, dont l'élément racine est <iut>. Les éléments 
principaux nommés <etudiant> ont comme attributs id (numéro d'inscription) et nom. 
Chaque élément <etudiant> peut contenir autant d'éléments <uv> que désiré. Chaque UV 
doit avoir un nom, une durée et une note enregistrés dans des sous-éléments. Visualisez 
ce fichier dans un navigateur pour vérifier qu'il est bien formé. 

Exercice 2 

Lisez les éléments et les attributs du fichier iut.xml, et affichez-les dans un tableau 
XHTML. 

Exercice 3 

Créez un formulaire permettant d'insérer des données dans le fichier iut.xml. Le script 
doit permettre la visualisation éventuelle du fichier après l'insertion. 

Exercice 4 

Créez un formulaire de recherche permettant d'afficher à la demande les noms des 
étudiants par ordre alphabétique, ainsi que la liste des UV et leur nom. 
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Exercice 5 

Transférez toutes les données de la base voitures créée aux chapitres 13 et 14 dans un 
fichier XML d'abord en utilisant phpMyAdmin puis en écrivant un script PHP. La répar- 
tition des données dans des attributs ou comme contenu des éléments est libre. 

Exercice 6 

Transférez les données du fichier i ut . xrtil de l'exercice 3 dans une table MySQL. Créez la 
table auparavant en lui donnant comme clé primaire la valeur de l'attribut i d de l'étudiant. 
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Le framework PEAR 



En informatique, et particulièrement en POO, il est d'usage de dire qu'il ne faut pas réin- 
venter la roue. En effet, à quoi bon réécrire du code qui a déjà été fait et testé par d'autres, 
pour parvenir au même résultat. C'est cette idée qui a prévalu lors de la création des 
frameworks et de PEAR en particulier. PEAR est un ensemble de très nombreux modules 
adaptés aux situations les plus diverses que l'on peut rencontrer lors de la création de 
sites Web. Chaque module ou package est un ensemble de scripts écrits en PHP. L'arrivée 
de PHP 5 et de son modèle objet plus élaboré que celui, très primaire, de PHP 4, permet 
à PEAR de proposer désormais, pour chaque module, des classes dotées de nombreuses 
méthodes qui vous permettent d'utiliser aisément, et surtout d'adapter à vos besoins parti- 
culiers, chaque module. Il existe d'autres frameworks Open Source que PEAR comme 
Zend, Symphony . . . mais notre choix s'est porté sur PEAR non seulement parce que c'est 
l'un des plus anciens, qu'il est bien établi et constamment mis à jour, mais surtout parce 
qu'il nous semble plus facile d'accès. 

Installer PEAR 

Il est possible de récupérer les différents packages de PEAR sur le site http://pear.php.net, 
mais il existe un moyen plus pratique qui consiste à utiliser un installeur qui permet non 
seulement d'installer les packages de base, mais aussi de gérer la recherche et l'installa- 
tion des packages en fonction de vos besoins ainsi que de les mettre à jour en un clic. 
Pour cela, il vous faut tout d ' abord récupérer le fichier nommé g o - p e a r . p h p soit sur le site 
de PEAR cité plus haut, soit dans le répertoire wamp/apps dans lequel vous avez installé le 
serveur local Wampserver2. Transférez -le ensuite sur le serveur de votre site distant via 
un logiciel FTP, comme pour les fichiers habituels, puis lancez-le à partir d'un navigateur. 
Vous obtiendrez la page présentée à la figure 20-1. Laissez-vous alors guider et fournissez 
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vos paramètres de connexion FTP. L'installeur PEAR se chargera de transférer sur le 
serveur les fichiers nécessaires à toutes les applications PEAR. 



C^EAR:: Installer :â9'Pf ' ' '^^^^^^^^^^^^^^^^^^^^^^^B^^/ISÊ 
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Figure 20-1 

L'installeur de PEAR 



Une fois les packages de base installés, vous disposerez d'un gestionnaire de packages. 
La page du PEAR Package Manager est présentée à la figure 20-2. 
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Figure 20-2 

Le PEAR package Manager 



Le framework PEAR 

Chapitre 20 



Grâce à ce dernier, vous pouvez choisir puis installer automatiquement les packages 
dont vous avez besoin. Pour vous donner une idée de ce que PEAR peut vous offrir 
nous allons maintenant, à titre d'initiation, mettre en œuvre de package PEAR HTML_ 
QuickForm qui permet de créer des formulaires XHTML. 



Le package HTML_QuickForm 

Installez tout d'abord, dans le Package Manager, le package HTML_Qui ckForm dans le réper- 
toire www/pear/ de votre serveur, par exemple. Celui-ci vous permet, comme son nom 
l'indique, de créer simplement des formulaires sans avoir à écrire directement de code 
XHTML. Il est même envisageable de créer ces formulaires dynamiquement et d'adapter 
leurs champs au visiteur du site, afin de créer, par exemple, un questionnaire différent s'il 
s'agit d'un particulier ou d'une entreprise, d'un homme ou d'une femme. 

La démarche à suivre est la suivante: 

1. Inclure les fichiers PEAR nécessaires (en règle générale ils sont indiqués dans la 
documentation des classes). 

2. Créer un objet représentant l'ensemble du formulaire correspondant à l'élément 
XHTML <form>. 

3. Créer les objets représentant les composants visibles (ou éventuellement cachés) du 
formulaire. Il peut s'agir d'éléments de saisie de texte ou de mot de passe, de boutons 
radio, d'envoi, d'effacement, de cases à cocher ou encore de listes déroulantes de 
sélection correspondant aux éléments XHTML <input />, <select> et <option>. Notez 
que les éléments seront visibles dans l'ordre de leur codage. 

4. Ajouter ces objets à l'objet formulaire. 

5. Créer des règles de validation du formulaire qui consistent à vérifier qu'il est bien 
complété ou que les données ont un format correct. 

6. Afficher le formulaire explicitement dans la page XHTML. 
Ce sont ces différentes phases que nous allons aborder maintenant. 

Lobjet formulaire 

C'est une instance de la classe HTMLJui ckForrti dont le constructeur a pour syntaxe : 
I HTML_QuickForin(string nomp.string méthode, string action) 

Les paramètres correspondent aux attributs de l'élément <form> : nomp correspond aux 
attributs id ou name qui identifient l'élément pour y faire référence dans un style CSS par 
exemple ; méthode vaut ' get ' ou ' post ' et c'est cette dernière valeur que nous utiliserons ; 
action désigne le nom du fichier PHP qui traitera les données saisies dans le formulaire, 
si vous l'omettez ce sera par défaut le fichier qui crée le formulaire lui-même. 

Avant de créer l'objet, il faut inclure le fichier QuickForm. php qui contient le code de la 
classe instanciée. 
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Nous avons donc par exemple le code suivant : 

Irequi re_once" HTML/Qui ckForm.php" ; 
$form = new HTML_QuickFonn( 'forml' , 'post', 'traitement.php'); 

Nous pouvons ensuite créer un en-tête de présentation contenant un texte à l'attention du 
lecteur. Ceci se fait, comme l'ajout des autres éléments, avec la méthode addEl ement( ) de 
l'objet $form selon la syntaxe : 

I $form->addEl ement( 'header' , '', 'Complétez le questionnaire'); 

Composants de saisie de texte 

Les composants de saisie de texte permettent au visiteur de donner son nom, son e-mail, 
son mot de passe (dans ce cas, les caractères saisis sont cachés) ou des longs textes, 
comme des commentaires. Il existe plusieurs techniques pour ajouter des composants à 
un formulaire, la plus simple étant la méthode addEl ementO de l'objet $form, dont les 
paramètres indiquent le type de l'élément, mais nous avons choisi ici d'employer celle 
qui utilise les classes spécialisées, adaptées à chaque type de composant. 

Les éléments de texte simple 

Les éléments de texte simple sont des instances de la classe HTMLJuickFormJext dont le 
constructeur a pour syntaxe : 

I HTML_QuickForm_text(string nom, string label, divers attributs) 

Outre le nom de l'élément, la définition du paramètre label permet d'afficher un texte 
devant la zone de saisie. Le paramètre attri buts permet d'affecter des valeurs aux attri- 
buts de l'élément XHTML <input />, sous la forme soit d'une chaîne du type 
"attri but=valeur", soit d'un tableau associatif dont les éléments s'écrivent attribut 
=>val eur. 

Pour créer, par exemple, une zone de texte demandant le nom d'une personne, précédée 
du label « Votre nom » et d'une largeur visible de 55 caractères, nous écririons le code 
suivant : 

require_once 'HTML/QuickForm/text.php' ; 

$txtnom=new HTML_QuickForm_text( 'nom' , 'Votre nom' , 'size=55' ) ; 
$form->addEl ement($txtnom) ; 

Cet objet possède plusieurs méthodes dont on peut retenir les suivantes : 

• setSize(string N) fixe la taille visible à N caractères ; 

• setMaxlengthC string N) limite la taille du texte saisi à N caractères ; 

• getVal ue( ) récupère la valeur saisie ; 

• setValue(string texte) définit le texte de la zone (afin de pré -remplir un questionnaire 
par exemple). 

Le résultat obtenu est représenté à la figure 20-3, repère O. 
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Les éléments de saisie de mot de passe 

Ils se différencient des précédents par le fait que les caractères saisis sont remplacés par 
des points. Ce sont des objets de type HTML_QuickForm_password dont la syntaxe du cons- 
tructeur est : 

I HTML_QuickForin_password(string nom, string label, divers attributs) 

Les paramètres ont ici les mêmes rôles que pour l'élément texte. La méthode setMax- 
length(N) permet de forcer un mot de passe à avoir N caractères au maximum. Le fichier 
à inclure est password.php. 

Le code de création d'une zone de saisie de mot de passe limité à 6 caractères serait : 

require_once 'HTML/QuickForm/password.php' ; 

$pass= new HTML_QuickForm_password( 'pass' , 'Votre pass'); 

$pass->setMaxLength( '6' ) ; 

$form->addEleinent($pass) ; 

Le résultat obtenu est représenté à la figure 20-3 repère Q. 
Les éléments de texte multiligne 

Ils permettent à un visiteur de saisir, par exemple, un commentaire de plusieurs lignes. 
Ce sont des objets du type HTML_QuickForm_textarea dont le constructeur a pour syntaxe : 

I HTML_QuickForin_textarea(string nom, string label, divers attributs) 

Dans le cas de cet élément, certains attributs sont indispensables et vous devez les définir 
sous la forme d'un tableau qui sera passé comme troisième paramètre. Par exemple, pour 
créer une zone de saisie de texte de 55 caractères de large et de 16 lignes de haut, nous 
créons le tableau suivant : 

I $optarea=array( "rows"=>16, "col s"=>55) ; 

puis l'objet lui-même : 

Irequire_once 'HTML/QuickForm/textarea.php' ; 
$zone= new HTML_QuickForm_textarea( 'zonel' , 'Vos commentaires' ,$optarea) ; 
$form->addElement($zone) : 

La méthode setVal ue( ) permet de définir un texte qui sera affiché dans la zone de saisie 
pour préciser la demande, comme : 

I $zone->setVal ue( ' Ecrivez vos commentaires ici'); 

Les dimensions peuvent être modifiées dynamiquement avec les méthodes : 

I$zone->setCols(50); //pour avoir 50 caractères de marge 
$zone->setRows(15) ; //pour avoir 15 lignes de haut 

Le résultat obtenu est représenté à la figure 20-3 repère Q. 
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Les boutons radio 

Ils permettent d'effectuer des choix, exclusifs l'un de l'autre si vous leur attribuez le 
même nom, ou indépendants si les noms sont différents. Les objets sont du type HTML_ 
QuickForm_radio et le fichier à inclure est radio. php. La syntaxe du constructeur est : 

IHTML_QuickForni_radio(string nom, string label, string texte, string valeur, 
^divers attributs) 

Le paramètre label permet de présenter le ou les boutons, texte constitue le choix 
proposé et valeur est la chaîne qui sera récupérée par le programme de traitement des 
données. 

Le code de création de deux boutons radio exclusifs l'un de l'autre (même paramètre nom) 
et proposant le choix du sexe serait donc : 

require_once 'HTML/QuickForm/radio.php' ; 

$radiol=new HTML_QuickForm_radio( 'sex' , 'Votre sexe' , 'Homme' , 'H' ); 
$radio2=new HTML_QuickForm_radio( ' sex' , ' ' , ' Femme' , ' F' ) ; 
$form->addEl ement($radiol ) ; 
$form->addElement($radio2) ; 

Le résultat obtenu est représenté à la figure 20-3 repère Q. 

Les cases à cocher 

Les cases à cocher permettent de faire des choix et autorisent les choix multiples. Les 
objets correspondants sont du type HTMLJuickForm_checkbox et il faut inclure le fichier 
checkbox. php. La syntaxe du constructeur est la suivante : 

I HTML_QuickForm_checkbox(string nom, string label, string texte, divers attributs) 

Les paramètres nom, 1 abel et texte sont identiques à ceux des boutons radio et il est néces- 
saire d'ajouter au moins un attribut, sous la forme d'une chaîne "value=valeur", pour 
désigner la valeur associée à chaque case qui sera récupérée sur le serveur. 

Pour proposer au visiteur de préciser ses goûts, nous aurions par exemple deux cases à 
cocher créées par le code suivant : 

require_once 'HTML/QuickForm/checkbox.php' ; 

$casel=new HTML_QuickForm_checkbox( 'caser , 'Vos Goûts', 'Sucré', 'value^l'); 
$case2=new HTML_QuickForm_checkbox( 'case2' , '', 'Salé', 'value=2'); 
$form->addElement($casel) ; 
$form->addElement($case2) ; 

Les objets checkbox possèdent, entre autres, les méthodes getTextO et setTextO 
employées respectivement pour lire ou définir le texte associé à la case ; les méthodes 
getVal ue( ) et setVal ue( ) pour lire ou modifier la valeur associée et, enfin, getChecked( ) 
qui permet de cocher dynamiquement un case. 

Le résultat obtenu est représenté à la figure 20-3 repère 0. 
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Les listes de sélection 

Les listes de sélection permettent d'effectuer un ou plusieurs choix dans une liste dérou- 
lante d'options prédéterminées. L'objet PEAR est du type HTML_QuickForm_select et le 
fichier à inclure est sel ect . php. Le constructeur a pour syntaxe : 

I HTML_QuickForin_select(string nom, string label, array options); 

Les options de la liste sont fournies dans un tableau associatif dont les clés correspondent 
aux valeurs qui seront récupérées sur le serveur et les valeurs aux textes visibles des 
options. La méthode addOption(string texte, string val eur) permet d'ajouter dynami- 
quement des options à la liste (notez que les paramètres sont dans l'ordre inverse par 
rapport au tableau). Pour autoriser les choix multiples dans la liste, il faut appeler la 
méthode setMultiple(boolean). Pour créer une liste de trois options, puis ajouter une 
nouvelle option et autoriser les choix multiples, nous aurions le code suivant : 

require_once 'HTML/QuickForm/select.php' ; 

$taboptions=array( 'un'=>'OptiDn 1', 'deux'=>'Option 2', 'trois'=>'Option 3'); 

$liste= new HTML_QuickForin_select( 'liste' , 'Votre choix', Staboptions) ; 

$form->addEl ement($l iste) ; 

$1 iste->addOption( 'Option 4' , 'quatre' ) ; 

$liste->setMLiltiple(TRUE) : 

Le résultat obtenu est présenté à la figure 20-3, repère ©. 

Le package QuickForm permet aussi de créer, avec très peu de code, des listes de sélection 
de dates avec plusieurs listes déroulantes pouvant contenir l'heure, le jour, le mois ou 
l'année pour saisir des informations comme une date de naissance complète. Ce type 
d'objet est très pratique car, pour écrire l'équivalent en XHTML, il faudrait créer trois 
listes contenant une option par jour, mois ou année, ce qui représenterait des dizaines de 
lignes. Le type d'objet est HTML_QuickForm_date et il faut inclure le fichier date. php. La 
syntaxe du constructeur est : 

I HTML_QuickForin_date(string nom, string label, array options) 

Le tableau associatif options contient quatre éléments dont les clés sont 'language', 
'format', 'minYear' et 'maxYear'. Pour avoir les jours et les mois en français, il suffit de 
donner la valeur ' f r ' au paramètre ' 1 anguage ' . Le format définit les informations que va 
contenir la liste à partir des options présentées dans le tableau 20-1. 



Tableau 20-1. Options du paramètre format de l'objet QuickForm 



Caractère 


Signification 




D 


Le jour de la semaine en trois lettres 




1 (L minuscule) 


Le jour de la semaine en entier 




d 


Le quantième du mois 




M 


Le nom du mois en trois ou quatre lettres 




F 


Le nom du mois en entier 
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Tableau 20-1. Options du paramètre format de l'objet QuIckForm (suite) 



m 


Le numéro du mois 


Y 


L'année en quatre ctiiffres 


y 


L'année en deux chiffres 


h 


L'hieure de 0 à 12 


H 


L'Iieure de 0 à 23 


i Les minutes 


s 


Les secondes 


a 


Afficfiage am/pm 


A 


Afficfiage miPU 



Pour définir un intervalle de saisie de dates comprenant le jour du mois, le mois et 
l'année comprise entre 1959 et 2009, nous aurons le tableau suivant : 

$options = arrayC 

'language' => 'fr', 

'format' => 'dMY' . 

'minYear' => '1959' . 

'maxYear' => '2009' 

): 

Pour créer l'objet date ci-dessus nous écrivons le code suivant : 

$options = arrayC 

'language' 'fr', 
'format' 'dl^Y' . 

'minYear' => '1959'. 
'maxYear' => '2009' 

): 

$listedate= new HTML_Quicl<Forni_date( 'listedate' , 'Date de naissance'. $options); 
$form->addEl ement($l i stedate) ; 

Comme il n'y a qu'un seul nom pour ce composant et en réalité trois éléments XHTML 
<sel ect>, pour pouvoir récupérer les informations dans des variables via la superglobale 
$_POST, la classe crée un tableau multidimensionnel dont les clés de premier niveau sont 
les lettres utilisées dans la définition du format. Pour l'objet date, dont le nom est 
1 1 stedate, le tableau retourné est le suivant : 

|["listedate"]=> arrayO) { [''d"]=> string(l) "1" ["M"]=> string(l) "1" ["Y"]=> 
^string(4) "1959" 

Le résultat obtenu est présenté à la figure 20-3, repère Q. 
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Les champs cachés 

Comme leur nom l'indique, ce sont les seuls éléments du formulaire qui ne sont pas visi- 
bles par l'utilisateur. Ils servent à transmettre au serveur des informations non saisies, 
comme le nom du navigateur utilisé ou la date exacte d'envoi du formulaire. Ce sont 
des objets du type HTML_QuickForrti_hidden et le fichier à inclure est hidden.php. Le cons- 
tructeur a pour syntaxe : 

I HTML_QuickForm_hidden(string nom, string valeur); 

Pour illustrer leur emploi nous créons avec le code ci-dessous un champ caché qui trans- 
met le timestamp de l'envoi, fourni par la fonction time( ) : 

require_once 'HTML/QuickForm/hidden.php' ; 
$cache=new HTML_QuickForm_hidden( ' 1 adate' , timeO); 
$form->addEleinent($cache) ; 

La valeur transmise est bien un élément du tableau $_POST. 



Les boutons d'envoi 

Un formulaire ne se conçoit pas sans quelques boutons, au minimum un bouton d'envoi 
(submit) déclenchant l'envoi des données au serveur qui les traite et, éventuellement, un 
bouton de réinitialisation qui remet les champs dans leur état initial en cas de mauvaises 
saisies. Chacun d'eux correspond aux types d'objets HTML_QuickForm_sijbmit et HTML_ 
QuickForm_reset. Les fichiers à inclure sont submit. php et reset.php. Les constructeurs ont 
pour syntaxe : 

IHTML_QuickForin_submit(string nom, string valeur) 
HTML_QuickForm_reset{string nom, string valeur) 

Le paramètre val eur est surtout utile quand le formulaire contient, par exemple, plusieurs 
boutons d'envoi, ce qui permet de décider quelle action effectuer dans le script de traite- 
ment des données après l'envoi. Un formulaire se termine donc généralement par le code 
suivant : 

require_once 'HTML/QuickForm/submit.php' ; 
require_once 'HTML/QuickForm/reset.php' ; 
$reset=new HTML_QuickForm_reset( ' efface ' , ' Effacer' ) ; 
$form->addElement($reset) ; 

$envoi=new HTML_QuickForm_submi t( 'envoi ' , ' Envoyer' ) ; 
$form->addElement($envoi ) ; 

Le résultat obtenu est présenté à la figure 20-3, repères © et Q. 



Les règles de validation 

Un bon formulaire doit également être capable de vérifier si les saisies du visiteur sont 
conformes à certaines règles. Certains champs peuvent, par exemple, être obligatoires, le 
mot de passe peut être limité à un nombre de caractères minimal ou maximal et l'e-mail 
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doit obligatoirement répondre à un format international reconnu. C'est dans ce domaine, 
bien plus que dans la création automatique de code XHTML, que QuickForm révèle tout 
son intérêt pour vous faire gagner du temps de développement et de test. Il est en effet 
très simple d'ajouter des règles de validation au formulaire avec la méthode addRuleO, 
dont la syntaxe est la suivante : 

I$form->adclRule(string noin_el ement , string message, string règle, divers info, 
^string lieu); 

Le premier paramètre est le nom du composant de formulaire à valider et le second, 
le message affiché en cas de non conformité. Le paramètre regl e précise, quant à lui, le 
type de règle à utiliser. Il en existe une dizaine, adaptées aux cas les plus courants. Les 
mots-clés à utiliser sont énumérés dans le tableau 20-2. 



Tableau 20-2. - Les règles de validation. 



Règle 


Signification 


reqji red 


Le champ doit obligatoirement être complété. 


iïiaxlength 


Il faut saisir un nombre maximum de caractères. 


minlength 


Il faut saisir un nombre minimum de caractères. 


rangel ength 


Il faut saisir un nombre de caractères compris dans un intervalle. 


emai 1 


L'adresse e-mail doit être conforme au format normalisé. 


1 ettersonly 


Seuls les caractères aiptiabétiques sont autorisés. 


alphanumeric 


Seuls les caractères aiptianumériques sont autorisés. 


numeri c 


Seuls les chiffres sont autorisés. 


nopunctuation 


Aucun signe de ponctuation n'est admis. 


nonzero 


La saisie ne doit pas comporter de zéro. 



Certaines règles doivent être précisées à l'aide du quatrième paramètre, qui peut être une 
chaîne de caractères contenant un nombre pour les règles maxl ength et minlength, ou un 
tableau de la forme array(Min,Max) pour la règle rangel ength. Le dernier paramètre, 1 ieu, 
indique si la vérification doit être effectuée côté client avec JavaScript, ou côté serveur 
avec PHP ; ce paramètre prend donc la valeur 'client' ou 'server ' . Pour rendre la saisie 
du mail obligatoire et vérifier sa conformité coté client nous écrivons : 

I$form->addRule( 'mail ' . 'Indiquez un mail valide', 'email', null, 'client'); 
$form->addRule( 'mail ' , 'Indiquez votre mail', 'required', null, 'client'); 

Les messages d'information indiquant qu'un champ est obligatoire et ceux des boites 
d'alerte JavaScript étant libellés en anglais, nous pouvons les franciser à l'aide des 
méthodes suivantes de l'objet $form : 

(//Francisation des messages 
$form->setRequiredNote( '* = Saisie obligatoire'); 
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pour l'avis des saisies obligatoires et : 

I $form->setJsWarnings( ' Réponse non valide ', 'Corrigez la saisie'); 
pour les boites d'alerte. 

L'exemple 20-1 récapitule la création de tous les éléments que nous venons d'aborder. 
Nous y trouvons tout d'abord l'inclusion des différentes fichiers nécessaires à la création 
des objets du formulaire (repère O), puis nous créons l'objet représentant le formulaire 
(repère 0) suivi par l' en-tête de présentation (repère 0). Viennent ensuite les champs de 
texte et d'e-mail (repère O), le mot de passe (repère 0) et la zone de saisie de commen- 
taires (repère 0), puis les boutons radio (repère 0) et les cases à cocher (repère 0). 
Les éléments suivants sont les listes déroulantes classiques (repère 0) et de dates 
(repère ®)- Nous concluons la liste des éléments visibles par la création des boutons 
d'envoi et d'effacement (repère 0). Un champ caché termine la création des composants 
(repère 0). L'ajout de règles de validation permet de contrôler les saisies de l'e-mail, du 
nom et du code (repère ©) et, enfin, nous appelons des méthodes de francisation des 
messages (repère©). La méthode displayO permet alors d'afficher le formulaire 
(repère ©). 

'•^ Exemple 20-1 . Création d'un formulaire avec QuickForm 

<!DOCTYPE html PUBLIC "-//WSC/ZDTD XHTML 1.1//EN" 

"http://www.w3.org/TR/xhtmlll/DTD/xhtmlll.dtd"> 
<html xmlns="http://www.w3.org/1999/xhtml " xml : 1 ang="f r"> 
<head> 

<meta http-equiv="Content-Type" content="text/html ; charset^i so-8859-r' /> 

<ti tl e>Formul ai re HTML_Qui ckForm</ti tle> 

</head> 

<body> 

<?php 

//Inclusion des fichiers <—0 
requi re_once "HTML/Qui ckForm. php" ; 
require_once 'HTML/QuickForm/textarea.php' ; 
requi re_once ' HTML/Qui ckForm/text. php' ; 
require_once 'HTML/QuickForm/radio.php' ; 
require_once 'HTML/QuickForm/checkbox.php' ; 
require_once 'HTML/QuickForm/select.php' ; 
require_once 'HTML/QuickForm/password.php' ; 
require_once 'HTML/QuickForm/date.php' ; 
require_once 'HTML/QuickForm/hidden.php' ; 
require_once 'HTML/QuickForm/submit.php' ; 
require_once 'HTML/QuickForm/reset.php' ; 

//Création du formul ai re <— 0 

$form = new HTML_QuickForm( 'forml' , 'post' , 'traitement. php' ) ; 
//Création d'un en-tête ^0 

$form->addElement( 'header' . ' ' , 'Complétez le questionnaire'); 



//Composants de texte <— O 

$txtnom=new HTML_QuickForm_text( 'nom' , 'Votre nom' , 'size=55' ) ; 
$form->aclclEl ement($txtnom) ; 
//Ou encore 

//$form->addEl ement( 'text' , 'nom' , 'Votre nom' , 'size=55' ) ; 
$txtprenom=new HTML_QuickForm_text( ' prénom' , 'Votre prénom' , ' size=55' ) ; 
$form->addElement($txtprenom) ; 

$mail=new HTML_QuickForm_text( 'mail ', 'Votre mail'); 
$form->addElement($mail ) ; 

//Password <— 0 

$pass= new HTML_QuickForm_password( 'pass' , 'Votre pass'); 
$pass->setMaxLength( ' 6 ' ) ; 
$form->addElement($pass) ; 

//Texte 1 ong <— © 

$optarea=array( "rows''=>"16" , "col s"=>"55" ) ; 

$zone= new HTML_QuickForm_textarea( ' zonel ' , ' Vos commentai res ', $optarea) ; 

$zone->setCols(50); 

$zone->setRows(5) ; 

$zone->setValue( 'Écrivez vos commentaires ici'); 
$form->addElement($zone) ; 

//Radio 

$radiol=new HTML_QuickForm_radio( 'sex' , 'Votre sexe' , 'Homme' , 'H' ); 
$radio2=new HTML_QuickForm_radio( ' sex' , ' ' , ' Femme' , ' F' ) ; 
$form->addEl ement($radiol ) ; 
$form->addElement($radio2) ; 

//Checkbox <— © 

$casel=new HTML_QuickForm_checkbox( 'casel', 'Vos Goûts ', 'Sucré' , 'value=r ); 
$case2=new HTML_QuickForm_checkbox( 'case2'. '', 'Salé' ,' val ue=2' ) ; 
$form->addElement($casel) ; 
$form->addElement($case2) ; 

//Select <-0 

$taboptions=array( 'un'=>'Option 1' , 'deux'=>'Option 2' , 'trois'=>'Option 3'); 

$liste= new HTML_QuickForm_select( 'liste' , 'Votre choix' ,$taboptions) ; 

$form->addElement($liste) ; 

$1 i ste->addOption( 'Option 4' , 'quatre' ) ; 

$liste->setMultiple(TRUE): 

//Sélection de dates <—© 

$options = array( ' 1 anguage ' => 'fr' , 'format' => 'dMY' , 'minYear' '1959', 
^'maxYear' '2009'); 

$listedate= new HTML_OuickForm_date( 'listedate' , 'Date de naissance' ,$options) 
$form->addEl ement($l i stedate) ; 

//Boutons envoi et effacement ^© 

$reset=new HTML QuickForm resetC 'efface' . 'Effacer' ) : 
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$form->addElement($reset) ; 
//Ou encore 

//$forin->aclclElement( ' reset ' , 'efface', 'Effacer'); 
$envoi=new HTML_QuickForm_submi t( 'envoi ', ' Envoyer' ) ; 
$form->addElement($envoi ) ; 
//Ou encore 

//$form->addElement( 'submit' , 'envoi'. 'Envoyer'); 
//Champ caché <— ® 

$cache=new HTML_QuickForm_hidden( ' 1 adate' ,time( ) ) ; 
$form->addEleinent($cache) ; 

//Règles de vérification <—© 

$form->addRul e( 'mai r , 'Indiquez un mail valide', 'emai 1 ' ,null , ' cl ient ' ) ; 
$form->addRul e( 'mai r , 'Indiquez votre mail', 'required', null, 'client'); 
$form->addRule( 'nom' , 'Indiquez votre nom', 'required', null, 'client'); 
$form->addRule( 'pass' , 'Pass!', 'required', null, 'client'); 
$form->addRule( 'pass' , 'Code numérique', 'numeric', null, 'client'); 
$form->addRule( 'pass' , 'Code 4 chiffres mini', 'minlength', '4', 'client'); 

//Francisation des messages <—© 
$form->setRequi redNote( '* = Saisie obligatoire'); 
$form->setJsWarnings( ' Réponse non valide '.'Corrigez la saisie'); 

//Affichage du formulaire complets© 

$form->displ ay( ) ; 

?> 

</body> 
</html> 

La figure 20-3 montre le résultat obtenu. 



Récupération des données 

Les données du formulaire sont récupérables dans la variable superglobale $_POST, 
comme nous l'avons vu au chapitre 6. Pour le formulaire que nous venons de créer 
certaines données, comme celles du composant de date, sont transmises sous forme de 
tableau. Le fichier traitement. php, désigné comme dernier paramètre du constructeur de 
l'objet formulaire, peut avoir la forme suivante pour afficher toutes les saisies : 

<?php 

foreach($_POST as $cl e=>$val eur) 
{ 

if(is_array($valeur)) 
{ 

foreach($valeur as $cle=>$ssvaleur) echo "Elément : $cle Valeur associée : 
^Sssvaleur <hr />"; 

) 

el se 
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echo "Elément 



tcle Valeur associée : $valeur <hr />" 



} 

?> 



^ Formulaire HTML_QuickForm - Mozîlla Rrefox . • 

£ichicr EdîtîoQ Affichage Historique Marque pages Outils 2 

- » C X iî) { ^ http:/'/localhosl/chap20/quicltLphp 



Complétez le questionnaire 
'Votre nom ^ 
Votre prénom 

*Votremail Manhin 



T 



* Votre pass •••• 2 

Vus CUmmeulaireS tr.rjvrx vo.i mnnrntiiirrii ic;i 



Votre sexe 



Homme 
Femme 



Vos Gonts □ Sucré 




nSalc 


5 


Votre rhoix OpOon 1 






Option 2 




6 


Option 3 






Option 4 







Date de naissance 01 • Jan • 1959 • 
Fffaner 



8 

I Eiivoyei |L 9 

' = Saisie obligatoire 



Figure 20-3 

Le formulaire créé avec QuickForm 



PEAR : une multitude de packages 

Comme nous l'avons indiqué dès le début de ce chapitre, PEAR fournit une très grande 
quantité de packages adaptés à toutes les situations de création de sites statiques ou dyna- 
miques. Le tableau 20-3 indique la liste des catégories de packages, les chiffres entre 
parenthèses indiquant le nombre de packages compris dans chacune d'elles, soit un total 
de plusieurs centaines. Il semble difficile de ne pas y trouver l'application désirée. On 
peut conseiller, entre autres, les packages HTML_CSS dans le groupe HTML pour la création de 
styles, MDB2 dans le groupe Database, une couche d'abstraction pour la connexion à une 
base de données quelconque, ou encore Auth_HTTP dans le groupe Authenti fi cation pour 
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la sécurité d'accès et le groupe Mail. Vous pouvez retrouver cette liste et les liens vers la 
liste complète des packages de chaque groupe à l'adresse : http://pear.php.net/packages.php. 
Chaque package possède sa propre documentation avec, généralement, des exemples très 
utiles pour démarrer ainsi que la syntaxe des méthodes et des propriétés des objets qu'il 
contient. 



Tableau 20-3 - Les différentes catégories de packages PEAR, 
entre parenthèses le nombre de packages compris dans la catégorie 



Authentication (8) 


Benchmarl<ing (1) 


Caching (2) 


Configuration (1) 


Console (7) 


Database (31) 


Date and Time (22) 


Encryption (13) 


Event (2) 


File Formats (33) 


File System (6) 


Gtk Components (4) 


Gtl<2 Components (7) 


HTIVIL (40) 


HTTP (14) 


Images (19) 


Internationalization (6) 


Logging(1) 


IVIail (8) 


Matti(19) 


Networi<ing (55) 


Numbers(2) 


Payment (5) 


PEAR (20) 


PEAR Website (5) 


PHP (20) 


Processing (1) 


Science (1) 


Semantic Web (5) 


Streams (2) 


Structures (30) 


System (8) 


Text(19) 


Tools and Utilities (9) 


Validate (29) 


Web Services (41) 



XML (32) 



Exercices 

Exercice 1 

Créez un formulaire ayant pour titre « Adresse client ». Il doit contenir les champs de 
saisie du nom, du prénom, de l'adresse, de la ville et du code postal. Ajoutez-y les règles 
de vérification qui s'imposent. 

Exercice 2 

Réalisez un formulaire de saisie de login, e-mail et mot de passe, ce dernier doit 
comprendre entre 6 et 9 caractères. Créez les règles de vérification. 
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Exercice 3 

Concevez un formulaire demandant la saisie d'un prix HT et d'un taux de TVA. Le script 
doit afficher le montant de la TVA et le prix TTC dans deux zones de texte créées dyna- 
miquement. Les champs ne devant comporter que des chiffres et être obligatoires, créez 
les règles de vérification correspondantes. 
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Plutôt que de clore l'ouvrage par des études de cas, souvent difficiles à suivre pour qui ne 
les pas écrites, nous vous proposons quatre thèmes de travaux personnels qui constituent 
en quelque sorte des sujets de mémoire de fin d'études sur PHP. Chacun d'eux consiste à 
créer un site de complexité croissante. Des uns aux autres, les descriptifs sont de moins 
en moins détaillés afin de vous mettre progressivement dans une situation réelle de créa- 
tion de site. 

Les corrigés de ces travaux personnels sont téléchargeables depuis le site des édi- 
tions Eyrolles (http://www.editions-eyrolles.com) sur la page dédiée à l'ouvrage. Les sites 
correspondants peuvent en outre être consultés en fonctionnement réel sur le site Web 
http://www.funhtml.com/php5. 

Démarche à suivre 

Pour chaque projet vous devrez suivre la démarche suivante : 

1. Lire attentivement le cahier des charges proposé. 

2. Décomposer le site en différents modules, auxquels correspondront autant de pages. 

3. Établir un schéma général de fonctionnement mettant en relief les liens entre ces 
différentes pages. 

4. Tracer les grandes lignes de l'organisation de chaque page sous forme de schéma, en 
séparant le code HTML du code PHP. 

5. Écrire le code de chaque partie sans trop entrer dans les détails de design dans un 
premier temps. Le design relevant plus du designer que du programmeur, il ne vous 
concerne pas ici. 
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6. Effectuer des tests approfondis sur chaque page en essayant d'envisager les divers 
comportements des utilisateurs, leurs erreurs éventuelles et les effets de celles-ci sur 
votre code. 

7. Mettre en place l'ensemble des pages et tester leurs interactions dans les mêmes 
conditions. 

8. Si possible, faire tester le site par des personnes n'ayant aucune connaissance particu- 
lière du domaine et noter leur comportement vis-à-vis de l'interface proposée. Noter 
en particulier leurs hésitations et les questions qu'elles se posent pour accéder au 
service rendu par le site. Ce qui est évident pour le concepteur ne l'est pas forcément 
pour les utilisateurs. 

TP n° 1 . Un site de rencontres 

Ce premier thème, déjà ébauché au chapitre 16, est le plus simple. 
Son cahier des charges est le suivant : 

• Le site offre aux internautes sportifs la possibilité d'entrer en contact avec d'autres 
personnes pratiquants ou supporters d'un même sport dans un département donné. 

• Le site est réalisé avec PHP et une base SQLite. 

• Chaque page affiche un en-tête commun. 

• Pour avoir accès aux informations du site, chaque visiteur s'enregistre au préalable en 
tant que pratiquant ou supporter d'au moins un sport. 

• L'identification se fait par le biais de l'e-mail du visiteur. Une fois identifié, le visiteur 
a accès à une page de recherche affichant les coordonnées des personnes qui répondent 
aux critères qu'il a définis. L'autorisation d'accès et l'e-mail sont stockés dans un cookie. 

• Un visiteur non enregistré souhaitant accéder à la page de recherche est redirigé auto- 
matiquement vers la page d'inscription. 

• Si un visiteur déjà identifié veut s'inscrire pour un autre sport que celui de sa première 
inscription, le formulaire affiche ses coordonnées automatiquement dans le formulaire 
afin de lui faciliter la saisie. 

Uinterface 

L'interface comprend trois pages, la page d'accueil, la page d'inscription et la page de 
recherche, chacune dotée de fonctionnalités spécifiques. 

La page d'accueil 

Nommée index. php, la page d'accueil contient les éléments suivants : 

• En-tête commun. 

• Liste des sports existants dans la base. 
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• Zone de saisie de l'e-mail pour identifier le visiteur. Si l'e-mail figure déjà dans la 
base, un message de bienvenue s'affiche avec le nom du visiteur, et les données 
personnelles du visiteur sont enregistrées dans un cookie. Deux nouveaux liens sont 
créés dynamiquement, un vers la page de recherche et un vers la page d'inscription, 
permettant de s'enregistrer pour un nouveau sport. Si l'e-mail ne figure pas dans la 
base, le visiteur est redirigé automatiquement vers la page d'inscription. 

• Lien vers la page d'inscription pour les personnes non encore enregistrées. 
La page d'inscription 

Nommée ajout. php, la page d'inscription contient les éléments suivants : 

• En-tête commun. 

• Formulaire HTML d'enregistrement comprenant trois zones principales : 

- La première comporte les zones de saisie de texte pour le nom, le prénom, le dépar- 
tement et l'e-mail. 

- La deuxième contient une zone de sélection proposant le choix des sports existant 
dans la table sport. Cette liste est construite dynamiquement à partir des sélections 
des sports existants dans la base par les utilisateurs. Une seconde liste de sélection 
permet à l'utilisateur de choisir son niveau. Les choix possibles sont « débutant », 
« confirmé », « pro » ou « supporter ». Une zone de saisie de texte et un bouton 
d'envoi particulier permettent au visiteur d'ajouter un nouveau sport dans la table 
s'il n'est pas proposé dans la liste. Après l'enregistrement du nouveau sport, le visi- 
teur est dirigé vers la page d'inscription mise à jour avec ce nouveau sport. 

- Le formulaire se termine par les habituels boutons d'envoi et de réinitialisation. 

• Lien vers la page d'accueil. 

• Script vérifiant l'existence de saisies dans les zones de texte et les listes de sélection, 
enregistrant les données dans la base sporti f s et affichant l'identifiant généré. 

La figure 21-1 illustre ce que pourrait être le formulaire de la page d'inscription. 
La page de recherche 

Nommée recherche . php, la page de recherche contient les éléments suivants : 

• En-tête commun. 

• Formulaire de saisie contenant trois listes de sélection : 

- La première contient la liste des sports existants. Elle est construite dynamiquement 
à partir des données de la table sport, comme dans la page d'inscription. 

- La deuxième indique le niveau des pratiquants et comporte les mêmes valeurs que 
dans le formulaire d'inscription. 

- La troisième contient la liste des départements dans lesquels il existe des personnes 
inscrites. Elle est construite dynamiquement à partir des données de la table 
personne. 
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;: File Edit View Go Boolcmarlts Tools Window He^ 



^Home l^uookmarls -^moaila-org -^mozia^e ■^mozdev.org 



Le site des rencontres sportives 

Vos coordonnées 



Nom . 
Prénom : 
Département : 
Mail: 



-Vos pratiques sportives 

Sport pratiqué : |choicicGC2r i OU" : Ajouter un sport à la Este ^ 
Niveau : [Débutanl v 



Ajouter 



m ■'J^ ^ ^ Donc 



Figure 21-1 

Le formulaire d'inscription 

• Lien vers la page d' accueil. 

• Lien vers la page d'inscription. 

• Script traitant les informations saisies et affichant la liste des partenaires correspon- 
dants dans un tableau XHTML. Les données saisies sont réaffichées dans le formulaire 
afin de faciliter une éventuelle nouvelle recherche de l'utilisateur. 



Le formulaire de recherche doit ressembler à celui illustré à la figure 21-2. 
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;: File Edit View Go Bookmarks Tools Window Help 


^ttHome 14|Bool<anar1(5 ■^mozila.org ■^mo^'Sne ■^mozdev.org 


Le site des rencontres sportives 


11 


rijccnercner acs pancnaires 
i>port pratiqué : tennis y 
Niveau: IDcbutant j,** 
Département: Choisissez! v, 
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Figure 21-2 

Le formulaire de recherche 
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La base de données SQLite 

La définition des besoins pour la conception de la base de données sportifs a déjà été 
abordée au chapitre 16. Les contraintes à respecter sont les suivantes : 

• Les entités en présence sont une personne et un sport. 

• Une personne peut pratiquer un ou plusieurs sports. La cardinalité du coté de l'entité 
personne est donc l.N. 

• Un sport peut être pratiqué par une ou plusieurs personnes. La cardinalité du coté de 
l'entité sport est donc également l.N. 

• Ces entités sont reliées par l'association pratique, qui possède l'attribut niveau. 
Le modèle conceptuel de données, ou MCD, est illustré à la figure 21-3. 



personne 



id_personne 

nom 

prénom 

départ 

mail 




Figure 21-3 

Le modèle conceptuel de données de la base 



En appliquant les règles de normalisation présentées au chapitre 13, vous obtenez le 
modèle logique de données illustré à la figure 21-4. La table pratique représente l'asso- 
ciation entre les tables personne et sport. Sa clé primaire est la concaténation des clés 
primaires des tables qu'elle associe. Elle a de plus un attribut niveau. 



personne 


► 


pratique 




sport 


id personne 


id personne 


id sport 


nom 




id sport 


design 


prénom 




niveau 






départ 










mail 











Figure 21-4 

Le modèle logique de données (MLD) de la base 



TP n° 2. Dictionnaire de citations interactif 

Ce TP est une première mise en œuvre simple d'une base de données MySQL. Le projet 
consiste à créer un dictionnaire de citations littéraires interactif en ligne. Il ne s'agit pas 
donc d'une banque de données statique mise en consultation. Chaque visiteur peut en 
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enrichir le contenu avec ses citations préférées, qui sont ensuite rendues accessibles à 
tous. Le concept du site se rapproche de celui d'un forum puisque les données ne sont pas 
figées. 

Linterface 

Pour créer une unité dans le site, chaque page doit incorporer les mêmes en-tête et pied 
de page. L'interface comprend trois pages, la page d'accueil, la page d'affichage des 
résultats et la page d'insertion. 

La page d'accueil 

Nommée index. php, la page d'accueil comporte, outre les éléments décoratifs laissés à 
votre libre choix, les éléments suivants : 

• Bandeau contenant la citation du jour tirée au sort dans la base et affichée lors de 
chaque connexion. 

• Formulaire de recherche contenant une zone de saisie de texte dans laquelle le visiteur 
saisit un mot-clé de recherche d'une citation. Il peut aussi préciser sa recherche en 
choisissant dans une liste de sélection parmi les auteurs présents dans la base. Cette 
liste est construite dynamiquement en interrogeant la base. Un dernier critère de sélec- 
tion est constitué d'une seconde liste de sélection permettant de choisir le siècle des 
citations, du XVI*^ au XXI''. Le critère de tri des résultats se fait par auteur ou par siècle 
en fonction du choix effectué à l'aide de boutons radio. Aucun de ces critères n'étant 
obligatoire, chaque choix doit posséder une valeur par défaut consistant à afficher 
l'ensemble des citations. Le script de traitement de ce formulaire se trouve sur la page 
d'affichage des résultats. 

• Lien vers la page d'insertion de nouvelles citations. 
La page d'affichage des résultats 

Nommée af f i checi t . php, la page d'affichage des résultats contient les éléments suivants : 

• Script gérant les saisies du formulaire. Ce script construit la requête SQL dynamique- 
ment en fonction des choix opérés par le visiteur dans la page de recherche et gère 
l'absence de mot-clé et de choix dans les listes de sélection afin de ne pas créer de 
blocage du fait d'une requête mal construite. 

• Résultats de la recherche effectuée par un visiteur. Chaque citation est présentée dans 
une cellule de tableau HTML et est suivie du nom de l'auteur et de son siècle. Le tri 
des citations se fait par siècle ou par nom d'auteur selon le choix fait par le visiteur. 

• Lien vers la page d' accueil. 

• Lien vers la page d'insertion. 



Travaux personnels 




Chapitrez! 



La page d'insertion 

Nommée saisiecit.php, la page d'insertion comprend les éléments suivants : 

• Formulaire contenant deux zones de saisie de texte pour le nom et le prénom de 
l'auteur, une liste de sélection du siècle, une zone de saisie multiligne pour le texte 
de la citation, ainsi que les habituels boutons d'effacement et d'envoi. 

• Script de traitement des données situé dans le fichier lui-même, devant vérifier si 
l'auteur existe déjà dans la base puis insérer les données et afficher un avis d'insertion 
pour le visiteur. 

• Lien vers la page d'accueil. 

La figure 21-5 donne une idée de ce que pourrait être le formulaire d'insertion (ici pour 
les rencontres sportives du TP n° 1). 



Le site des rencontres sportives 

[—Vos coordonnées 

Nom : I I 

Prénom : | | 
Département : | | 
Mail: I I 

—Vos pratiques sportives 

Sport pratiqué : Choisissez! i v | OU ; Ajouter un sport à la liste | || Ajouter | 

Niveau : Déb utant v | 

I Envoyer | | Effacer | 

Rechercher des partenaires 



Figure 21-5 

Le formulaire d'insertion 

La base de données MySQL 

Nommée di co, la base de données doit répondre au modèle conceptuel de données repré- 
senté à la figure 21-6. Les contraintes sont les suivantes : 

• Un auteur peut avoir écrit plusieurs citations. 

• Une citation donnée ne peut être l'œuvre que d'un seul auteur. 
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auteurs 




idauteur 




nom 




prénom 


l.N 


siècle 






Figure 21-6 

Le modèle conceptuel de données de la base dico 



Le modèle logique de données réalisé en appliquant les règles du chapitre 13 est illustré 
à la figure 21-7. Il montre que la base dico ne contient que deux tables. 



auteurs 




citation 


idauteur 
nom 
prénom 
siècle 


idcit 

idauteur 

texte 


1 >- 





Figure 21-7 

Le modèle logique de données de la base dico 



TP n° 3. Commerce en ligne 

Ce troisième thème a pour but de vous placer dans une situation professionnelle. 

Vous y jouez le rôle d'un concepteur indépendant vis-à-vis d'un client qui n'est pas un 
professionnel du Web mais un commerçant. Il ne peut donc exprimer ses besoins dans 
un langage technique propre à Internet et à la programmation PHP, dont il ignore tout. 



Les besoins du client 

Le client dirige une PME qui vend des produits informatiques et vidéo. Vous devez lui 
créer un site de commerce en ligne pour vendre ses produits par correspondance. Son 
budget ne lui permettant pas de vous rémunérer en permanence pour maintenir le site, 
vous lui créez une interface Internet à accès privé lui permettant d'ajouter ou d'enlever 
des produits dans la base de données sans avoir à passer par un logiciel FTP. 



Travaux personnels 

Chapitre 21 



Votre travail 

Comme vous n'allez pas réinventer le concept de commerce en ligne et partir de zéro, 
vous vous inspirerez de ce qui existe déjà. Vous consulterez pour cela des sites de vente 
en ligne tels que eyrolles.com pour en étudier le fonctionnement. 

Il vous faudra en dégager les points essentiels et n'en retenir que ce qui correspond au cas 
relativement simple de votre client. 

En particulier, le nombre d'articles vendus par cette PME est relativement limité compara- 
tivement à ceux du site d'Eyrolles. Cela peut entraîner des simplifications dans la structure 
de la base, comme le fait de ne pas créer de table spéciale pour enregistrer le nom des 
marques des produits en magasin. 

Pour accéder à MySQL, utilisez de préférence l'extension mysqli (voir le chapitre 16) 
ou, encore mieux, pour les courageux, réalisez une version mysqli puis une version PDO 
(voir le chapitre 17). 

Fonctionnement du site 

Le site répond aux conditions suivantes : 

• Dans la page d'accueil, le client recherche un type de produit dans une des catégories 
informatique, vidéo et divers (pour les accessoires et consommables). Un tri par 
marque et par prix est proposé pour l'affichage des résultats. 

• Les résultats de la recherche sont affichés en respectant le critère de tri. Chaque 
produit est suivi d'un lien permettant sa sélection. 

• La sélection d'un produit entraîne sa mise en panier. 

• Après chaque sélection, le client peut soit rechercher un autre produit, soit terminer sa 
commande. 

• Dans ce dernier cas, l'ensemble de sa commande est affichée, et vous lui demandez 
ses coordonnées. 

• Si le client n'est pas encore enregistré, il saisit ses coordonnées complètes. Son 
adresse e-mail et un mot de passe lui serviront à s'identifier par la suite. Il saisit égale- 
ment le cas échéant l'adresse de livraison, qui peut être différente de l'adresse du 
client. Ces informations sont stockées à l'aide de sessions pour être transmises aux 
pages suivantes de la procédure d'achat. 

• Si le visiteur est déjà client, il ne saisit que son e-mail et son mot de passe. L'authenti- 
cité de ces informations est vérifiée dans la base, et les coordonnées complètes du 
client sont récupérées. Ces coordonnées sont utilisées pour remplir automatiquement 
un formulaire identique à celui du visiteur non enregistré. Ces informations sont égale- 
ment stockées à l'aide de sessions. 

• La phase de paiement par carte bancaire n'étant pas réalisable sans une convention 
bancaire, vous vous contentez de demander la saisie d'un numéro de carte et d'utiliser 
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un algorithme de vérification du numéro. Vous trouverez cet algorithme sur Internet en 
faisant une recherche à partir du mot-clé cl é de Luhn. 

• Si le paiement est bien réalisé, vous finalisez la transaction en enregistrant l'ensemble 
des informations dans les tables client, commande et ligne puis affichez le numéro de 
commande à destination du client. 

• Pour finir, vous envoyez un e-mail de confirmation au client et au dépôt du magasin 
chargé de la livraison. 

La base de données MySQL 

La base de données étant susceptible d'être soumise à de nombreux accès concurrents, le 
choix de MySQL s'impose par rapport à SQLite. La base magasin a déjà été présentée en 
détail au chapitre 13. La figure 21-8 présente le modèle conceptuel de données de cette 
base. 



client 



id client 

nom 
prénom 

âge 
adresse 
ville 
mail 



commande 



id comm 
id client 
date 



ligne 



id comm 
id article 
quantité 
prix_unit 



article 



id article 
design 
prix 
catégorie 



Figure 21-8 

Le modèle conceptuel de données de la base magasin 

Ce modèle est imposé afin que chaque lecteur travaille sur la même base. N'ajoutez 
aucun attribut aux entités représentées dans le modèle. Il vous appartient de recréer le 
MLD correspondant avant de créer la base avec phpMyAdmin. 

Conseils 

Les quelques conseils suivants vous permettront de réaliser plus facilement ce TP : 

• Établissez le schéma de fonctionnement du site avant de commencer le moindre codage. 

• Reportez-vous au chapitre 13 pour établir précisément le MLD de la base. 

• Reportez-vous aux chapitres 14 et 15 pour utiliser MySQL et revoir la partie concer- 
nant les jointures entre tables. 

• Reportez-vous au chapitre 12 pour implémenter les sessions, les cookies et les e-mails. 

• La création de fonctions de traitement est recommandée. 

• Ne vous précipitez pas sur le corrigé en cas de problème. Laissez d'abord décanter vos 
idées. 
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TP n°4. Création d'un blog 

Voici comment le site Wikipédia définit un blog {http://fr.wikipedia.org/wiki/Blog) : « un blog 
(mot-valise de web log) ou blogue est un site web constitué par la réunion de billets 
agglomérés au fil du temps et souvent classés par ordre déchronologique (les plus récents 
en premiers). Chaque billet (appelé aussi note ou article) est, à l'image d'un journal de 
bord ou d'un journal intime, un ajout au blog ; le blogueur (celui qui tient le blog) y déli- 
vre un contenu souvent textuel, enrichi d'hyperliens et d'éléments multimédias, sur 
lequel chaque lecteur peut généralement apporter des commentaires. » 

Il existe quantité de sites proposant soit d'héberger des blogs, soit des logiciels de créa- 
tion de blog (Wordpress par exemple, à l'adresse http://fr.wordpress.org/). Mais, encore une 
fois, notre but est de comprendre le fonctionnement d'une technologie et non pas d'utili- 
ser un produit fini. 

Vous devez donc gérer : 

• L'accès réservé pour une ou plusieurs personnes munies d'un identifiant et d'un mot 
de passe. 

• La saisie par ces personnes d'un contenu (généralement sans intérêt). 

• L'affichage de ces contenus impérissables (le plus récent d'abord). 

• La possibilité pour les visiteurs passionnés d'ajouter des commentaires. 

• La validation des commentaires par les personnes autorisées. 
L'ensemble doit être réalisé avec PHP et MySQL, géré par PDO. 
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Jean Engels 

Enseignant en mathématiques et consultant Web, Jean Engels est auteur de nombreux ouvrages 
portant sur les technologies du Web : (X)HTML, CSS, JavaScript, PHP et MySQL 



Un (ours idéal pour assimiler la syntaxe et les concepts objet de PHP 5 
et s'initier au développement d'applications Web professionnelles 

Ce manuel d'initiation vous conduira des premiers pas en PHP jusqu'à la réalisation d'un site Web complet interagissant avec 
une base de données MySQL ou SQLite. 

Après avoir appris à installer PHP et à créer quelques pages simples, vous étudierez en détail la syntaxe du langage 
(variables, types de données, opérateurs, instructions, fonctions, tableaux...), avant de progresser rapidement vers des sujets 
de niveau plus avancé : programmation objet, manipulation des chaînes de caractères et expressions régulières, gestion des 
mails, sessions et cookies, accès aux bases de données MySQL et SQLite, traitements XML, etc. 

Parmi les thèmes nouveaux abordés dans cette seconde édition : les nouveautés objet de PHP 5.3, l'accès objet à MySQL, 
l'accès PDO à MySQL et à SQLite, le framework PEAR. 

Des exercices corrigés et des travaux pratiques 

pour une mise en œuvre immédiate de vos connaissances 

Pour vous aider à valider et mettre en œuvre vos connaissances, vous trouverez en fin de chaque chapitre une série d'exercices 
dont les corrigés et le code source sont disponibles sur les sites www.editions-eyrolles.com et www.funhtml.com. Vous découvri- 
rez également en fin d'ouvrage quatre exemples de sites Web dynamiques présentés sous forme de travaux pratiques : à vous 
de développer ces applications à partir du cahier des charges et des indications données dans l'énoncé, en résistant à la tenta- 
tion de télécharger trop rapidement les solutions données sur le site des Editions Eyrolles ! 

A qui s'adresse ce livre ? 

• Aux étudiants en cursus d'informatique ou de design Web. 

• A toute personne ayant des bases de programmation Web (HTML, JavaScript. . .) et souhaitant s'autoformer à PHP 

• Aux enseignants et formateurs à la recherche d'une méthode pédagogique pour enseigner PHP 

Au sommaire 

Premier contact avec PHP • Variables, constantes et types • Les instructions de contrôle (if-else, for, while. . . ) • Les chaînes de 
caractères et les expressions régulières • Les tableaux • Les formulaires • Les fonctions • Dotes et calendriers • La programma- 
tion objet (classes et instances, héritage, nomespoces. . .) • Les images dynamiques • La gestion des fichiers • Cookies, sessions 
et emails • Rappels sur les bases de données relationnelles • Le langage SQL et phpMyAdmin • Accès procédural à MySQL avec 
PHP • Accès objet à MySQL avec PHP • PDO et MySQL • La base de données SQLite • PHP et SimpleXML • Le framework PEAR • 
Travaux dirigés : site de rencontres, dictionnaire de citations interactif, site de commerce électronique, création d'un blog. 
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